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DECLARATION UNDER 37 C.F.R. §1.131 



1. We are co-inventors of the Method and Apparatus for a Cable TV Server that is 
the subject of the above-identified patent application. 

2. We invented and created original source code prior to December 1 5, 1 999. The 
code name used for this project at that time was Arctos. 

3. The version control software used by our company was called Source Safe. 
Source Safe allows us as software developers to check out a file, make changes, 
and then check the file back in. SourceSafe is a version control system that 
allows back-tracking to previous versions of a file or the entire projects. To 
facilitate back-tracking and control of versions, SourceSafe maintains file change 
histories, audit trail logs, and disaster recovery for source code files. If files are 
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added or modified, Source Safe records will show it. Accuracy of Source Safe 
date stamps on source code files are guaranteed by its maker, Microsoft. 

4. Prior to December 15, 1999, the Arctos software was demonstrated in conjunction 
with a headend simulated by a Vivid™ Simulator acting as settop box code 
downloaders and Motorola DCCG DigiCable Control Channel Generator as 
channel map downloader, thereby demonstrating that the invention of the above- 
identified application had been reduced to practice. 

5. The project was active in the December 1999 time frame and much of the 
software was checked out to developers who sought to make improvements that 
might make the system more marketable. While the exact state of the software in 
the combination of software modules used to demonstrate the invention's 
capabilities prior to December 15, 1999 can not be precisely ascertained from the 
Source Safe records, the versions checked in shortly thereafter have been 
preserved. 

6. Relevant excerpts of the software dated prior to December 1 5, 1999 or shortly 
thereafter have been attached hereto as exhibits. Dates prior to December 15, 
1999 have been redacted to maintain their confidentiality. 

7. In particular, with respect to claim 1 , prior to December 15, 1999, the Arctos 
software included as part of the Carousel Explorer a browser application that 
produced a display of a web page. The browser application was called 
CarouselExplorerView.cpp and its source code as of prior to December 15, 1999 
is attached hereto as Exhibit A. 

8. Further prior to December 15, 1999, the Arctos software included an image 
capture module that captured successive images of the web page displayed by the 
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browser application. The image capture module was part of the Carousel 
Explorer. Its source code in its form when checked in on December 26, 1999 
called Screenlmage.cpp is attached hereto as Exhibit B. 

9. Further prior to December 15, 1999, the image compressor that compressed the 
successive images captured by the image capture module of the Arctos software 
was called CarToMux.cpp. The source code for CarToMux xpp in its form when 
checked in on December 23, 1999 is attached hereto as Exhibit C. 

10. Further prior to December 15, 1999, compressed images from the image 
compressor were assigned a transport control protocol internet protocol (TCP/IP) 
port number by ChannelMgr. Each port was associated with a corresponding 
television channel. Source code for the ChannelMgr. in its form when checked in 
December 31, 1999 is attached hereto as Exhibit D. 

1 1 . Further prior to December 15, 1999, the TCP/IP numbered streams were delivered 
by a multiplexer as separately selectable television channels thereby permitting 
simultaneous viewing at any of the subscriber televisions at which the channel is 
selected. The multiplexor was implemented prior to December 15, 1999 and a 
multiplexor source code file from prior to December 15, 1999 is attached hereto 
as Exhibit E. 

12. By December 15, 1999, Arctos software had been used to demonstrate a working 
embodiment of the web content server that produced a television channel 
containing images captured from a browser for viewing by any television 
connected to receive the television signal. 

13. The conception of the invention is documented in the attached Exhibit F entitled 
Arctos Version 1 .0 Functional Specification ("the Spec") and bearing document 
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EXHIBIT A 

Carousel Expl orervi ew. cpp 
// CarouselExplorerView.cpp : implementation of the CChannelview class 
// 

#include "stdafx.h" 

#include "Carousel Explorer. h" 

#i ncl ude "Carousel Expl ore rDefs . h" 

#include "carousel ExplorerDoc. h" 
#i ncl ude "carousel Expl orervi ew. h" 

#i ncl ude "MainFrm.h" 

#i ncl ude <atlbase.h> 
#i ncl ude "mshtml.h" 

#ifdef _DEBUG 
#define new DEBUG_NEW 
#undef THIS„FILE 

static char THIS_FILE[] = FILE ; 

#endif 

///////////////////////////////////////////////////////////////////////////// 
// CChannelview 

IMPLEMENT_dyncreate (CChannelview, CFormView) 

BEGIN_MESSAGE_MAP(CChannelView, CFormView) 

//{{AFX_MSG_MAP (CChannelview) 

ON_WM_WINDOWPOSCHANGING () 

//}}AFX_MSG_MAP 
END_MESSAGE_MAP() 

///////////////////////////////////////////////////////////////////////////// 
// CChannelview construction/destruction 

CChannelview: : CChannelvi ew() 

: CFormView(CChannelView: :IDD) 

//{{AFX_DATA_lNlT(CChannelview) 
m_strDescri ption = _T(""); 
// } } A FX_DATA_I NIT 

// TODO: add construction code here 



} 



m_lpDispDoc = NULL ; 



CChannelview: :~cchannelview() 

{ 

} 

void CChannelview: : DoDataExchange(CDataExchange* pDX) 

CFormView: : DoDataExchange(pDX) ; 
//{{AFX_DATA_MAP(CChannelView) 

DDX_Control (pDX, IDC_CHANN el_descri PTION , m_wndDescri pti on) ; 
DDX_Control (pDX, idc_explorer , rruwndBrowser) ; 
DDX_Text(pDX, idc_channel_description, m„strDescri pti on) ; 

// } } A FX_DATA_MA P 

} 

BOOL CChannelview: : PreCreatewi ndow(CREATESTRUCT& cs) 

{ 

CS. Style &= ~WS__OVERLAPPEDWINDOW; 
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cs. style &= ~ws_border; 
cs. style &= ~ws_dlgframe; 
cs. style &= ~ds_3dlook; 
cs. style &= -0x8000; 
cs.ciwExStyle &= ~WS„EX_WTNDOWEDGE; 

return CFormview: : preCreatewindow(cs) ; 

} 

///////////////////////////////////////////////////////////////////////////// 
// CChannelView diagnostics 

#ifdef _debug 

void CChannelView: : AssertVal i d() const 
{ 

CFormview: : AssertVal i d() ; 

} 

void CChannelView: : Dump (CDumpContext& dc) const 
{ 

CFormview: :Dump(dc) ; 

} 

cchannelDoc* CChannelView: :GetDocumentO // non-debug version is inline 

ASSERT (rrupDocument->Isj<indOf (RUNTIME_CLASS(CChannel Doc))) ; 
return (CChannelDoc*)m_pDocument ; 

} 

#endif //_DEBUG 

///////////////////////////////////////////////////////////////////////////// 
// CChannelView message handlers 

BEGIN„EVENTSiNK_MAP(CChannelview, CFormview) 
//{{AFX_EVENTSiNK_MAP(cchannelview) 

ON_EVENT(cchannelView, lDC_EXPLORER, 250 /* BeforeNavigate2 */, 

OnBeforeNavigate2, VTS_DISPATCH VTS_PVARIANT VTS_PVARIANT VTS_PVARIANT VTS_PVARIANT 
VTS_PVARIANT VTS_PBOOL) 

ON_EVENT(CChannel View, lDC_EXPLORER, 108 /•• Progresschange */, 
OnProgressChange , VTS_I4 VTS_I4) 

ON„EVENT(cchannelview, IDC_EXPLORER , 259 /* DocumentCompl ete */, 
OnDocumentCompl ete, VTS_DISPATCH VTS_PVARIANT) 

ON_EVENT(cchannelview, lDC_EXPLORER , 112 /'■' PropertyChange */, 
OnPropertyChangeExplorer , VTS_BSTR) 

ON_EVENT(CChannelView, IDC_EXPLORER, 252 /* Navi gateCompl ete2 */, 
onNavigatecomplete2, vts_dispatch vts_pvariant) 

//}}AFX_EVENTSINK_MAP 
END„EVENTSINK_MAPO 

void CChannelView: :OnBeforeNavigate2(LPDISPATCH pDisp, VARIANT FAR* URL, variant 
FAR" Flags, variant far* TargetFrameName, VARIANT far* PostData, variant far* 
Headers, bool far- cancel) 

"'•'Cancel = !GetDocumentO->BeforeNavigate(CStn'ng(URL->bstrVal)) ; 

} 

void CChannelView: :onProgresschange(long Progress, long ProgressMax) 

{ 

// traceC "After %d %d %s\n", Progress, ProgressMax, strurl); 

} 

void CChannelView: :oninitialUpdate() 
{ 
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Carousel Explo re rVi ew. cpp 
CFormView: :OnInitial Update () ; 

} 

void cchannelview: :OnDocumentCompTete(LPDlSPATCH pDisp, VARIANT far* URL) 
{ 

/* if (m_lpDi spDoc && m_lpDispDoc == pDisp) 

{ 

m_lpDi spDoc = null; 

*/ 

/* LPUNKNOwN lpunknown; 

LPUNKNOwN lpUnknownWB = NULL; 
lpunknown IpunknownDC = null; 

if (NULL != (lpunknown = m_wndBrowser .GetcontrolUnknown())) 

i f (succeeded(1 pUnknown->Querylnterface(llD_lunknown , 
(LPV0ID*)&1 pUnknownWB))) 

i f (SUCCEEDED (pDi sp->QueryInterface(IID_IUnknown , 
(LPVOiD*)&lpunknownDC)) && 

(lpUnknownWB == 1 pUnknownDC)) 

{ 

lpUnknownDC->Release() ; 

// Get the real document name from the document 

object 

CComPtr<IHTMLDocument2> i_doc = 
(lHTMLDocument2*)m_wndBrowser .GetDocumentO ; 

CString strUrl ("res://") ; 

if (i_doc != NULL) 

{ 

CComBSTR bstrUrl ; 

if (SUCCEEDED(i_doc->get_URL(&bstrUrl))) 
strUrl = bstrUrl ; 

} 

GetDocument()->SetCurrentUrl (strurl) ; 

/,- } 

lpUnknownWB->Release() ; 

} 

} 

*/ 

// > 
} 

void CChannel Vi ew: :OnPropertyChangeExplorer(LPCTSTR szProperty) 
{ 

/* TRACE("Property : '%s'\n", szProperty); 

variant var = m_wnd Browser .Getproperty_(szProperty) ; 
*/ 



void cchannelview: :onWindowPosChanging(wiNDOWPOS far* Ipwndpos) 
{ 

CFormView: :OnWi ndowPosChangi ng(l pwndpos) ; 

// Stretch the browser control to the window 

if ((HWND)m_wndBrowser) 

{ 
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m„wndBrowser.MoveWindow(-2, -2, 1 pwndpos->cx + 4, 
theApp.m_ScreenSize.cy + 4); 

m_wndDescription.MoveWindow(0, theApp.m_Screensize.cy + 4, 

lpwndpos->cx, Tpwndpos->cy - theApp.m_Screensize. cy - 4); 
} 

} 

void cchannelview: :0nNavigateComp1ete2(LPDISPATCH pDisp, variant far* URL) 
{ 

if ( ! m_l pDi spDoc) 

m_lpDispDoc = pDisp; 

} 
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Screenlmage.cpp 

// screenlmage.cpp: implementation of the cscreenlmage class. 

////////////////////////////////////////////////////////////////////// 

#include "stdafx.h" 
#include "Screenlmage . h" 

#ifdef _DEBUG 
#undef THIS_FILE 

static char THIS_FILE[]= FILE ; 

#define new DEBUG^NEW 
#endif 

////////////////////////////////////////////////////////////////////// 
// Construction/Destruction 

////////////////////////////////////////////////////////////////////// 

cscreenlmage: :CScreenImage(int CapWidth, int CapHeight) 

: m_SrcDC(CWnd : : GetDesktopwi ndow()) 

{ 

m_capwidth = capwidth; 
m_CapHeight = CapHeight; 

m„Total Frames = 0 ; 
m_TotalTime = 0; 

mJiDibsect = null; 
mjioldoibsect = null; 

/* m_pDi bSectBi ts = 0; 

m_BitsPerPixel = 0; 

m__Pi xel Buf Len = 0; 
m_BytesPerPixel = 0; 

m_capwidth - 0; 

m_CapHeight = 0; 
m_Dib5ect555 = FALSE; // TRUE if 15-bit RGB mode 



} 



V 



cscreenlmage: : -cscreenlmage () 
{ 

if (m_holdDibsect) 

m_Di bSectMemDC . Sel ectob j ect (m_hOl dDi bsect) ; 

if (m_hDi bsect) 

: : Del eteOb j ect (m_hDi bsect) ; 

} 

BOOL cscreenlmage: MnitO 

// Get information on the system display 
int planes = m_SrcDCGetDevicecaps (PLANES) ; 

m„BitsPerPixel = m_SrcDC.GetDeviceCaps(BITSPlXEL) * planes; // 8, 16, 

24, 32 , 
m_BytesPerPi xel = m_BitsPerPi xel / 8; 
// 1, 2, 3, 4 

m_Pi xel Buf Len = m_BytesPerPixel * m_CapWidth * m_CapHeight; 

UINT rastercaps = m_SrcDC.GetDevi cecaps (RASTERCAPS) ; 
UINT palettized = rastercaps & RC_PALETTE; 
if (palettized) 
{ 

TRACE("Palettized display cannot be used with mpeg encoder!"); 
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return false; 



// create the memory dc to draw into 

m„Di bsectMemDC . CreateCompati bl eDC(&m„SrcDC) ; 

// initialize the structure with the DIB parameters 
:ZeroMemory(&m_Di bSectBmpInfo, si zeof (DSBITMAPINFO)) 



m_Di bsectBmplnf o . bmi Header . bi si ze 
m„Di bsectBmplnf o . bmi Header . bi Wi dth 
m_Di bsectBmplnf o . bmi Header . bi Hei ght 
specifies top-down dib 

m_Di bsectBmplnf o . bmi Header . bi Pi anes 
m_Di bsectBmplnf o. bmi Header . biBitCount 
m_Di bsectBmplnf o . bmi Header . bi Compressi on 
m_Di bsectBmplnf o . bmi Header . bi Si zelmage 
riLDi bsectBmplnf o . bmi Header . biXPelsPerMeter 
m_Di bsectBmplnf o . bmi Header . bi YPel sPerMeter 
m_Di bSectBmpInfo . bmi Header . bi Cl rUsed 
m_Di bSectBmpInfo . bmi Header . bi Cl rlmportant 

m_hDibSect = NULL ; 



= BI. 

= 0; 
= 0; 

= 0: 



= Sizeof (BITMAPINFOHEADER) ; 

= m_capwidth; 
= -m_CapHeight; // negative 

= 1; 

= m_BitsPerPixel ; 

BITFIELDS ; 
= 0; 



= 0: 



// Only create a dib for 16 bit color mode 
if (m_BytesPerPi xel == 2) 
{ 

// for 16-bit 5-6-5, using BUITFIELDS 
m_Di bSectBmpInfo. r = 0x00F800; 
m_Di bsectBmplnf o.g = 0x0007E0; 
m_Di bsectBmplnf o.b = OxOOOOIf; 

// Attempt to create 5-6-5 format Dibsection. 

m_hDibSect = CreateDlBSection(0, (bitmapinfo *)&m_Di bSectBmpInfo , 
DIB_RGB_COLORS , (void * *) (&m_pDi bSectBi ts) , NULL, NULL); 

if Cm_hDibsect == null) 
{ 

// 

// Failed to create 5-6-5. Try 5-5-5. 

// NOTE: To maintain color integrity, current buffer must be 
// treated as upside-down from normal, so -positive* number must 
// be given as buffer Y-dim, and encoder's 'flip' flag is set. 
// 

m_Di bSectBmpInfo. r = 0x007c00 
m_Di bsectBmplnf o.g = 0x0003EU 
m„Di bsectBmplnf o.b = OxOOOOlF 

m_Di bSectBmpInfo. bmi Header. bi Hei ght = m_CapHeight; 

// 

// Attempt to create 5-5-5 format Dibsection. 

// mdq : ! ! ! ! NOTE: This may benchmark much slower than 5-6-5. 

// 

m_hDibSect = CreateDlBSecti on(0 , (bitmapinfo *)&m_Di bSectBmpInfo , 
DlB_RGB_COLORS, (voi d **) (&m_pDi bsectBi ts) , NULL, NULL); 



} 



} 



if (mJiDi bsect == null) 
// 

// Higher bit resolutions (24, 32) init here. 

// 16-bit create also gets one more chance if prev creates failed. 
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// 

// for 24/32-bit, using bi_bitfields 
// m_DibSectBtnplnfo. r = OxFFOOOO; 
// m_DibSectBmplnfo.g = OxOOffOO; 
// m_DibSectBmpInfo.b = OxOOOOFF; 

m_Di bSectBmpinfo.bmi Header .bi Compression = bi_rgb; 

// NOTE for 16-bit: To maintain color integrity, current buffer must 
// be treated as upside-down from normal, so ''positive-' number must 
// be given as buffer Y-dim, and encoder's 'flip' flag is set. 
// 

if (m_BytesPerPi xel == 2) 
{ 

m_Di bSectBmpinfo.bmi Header .bi Height = m_CapHeight; 

} 

// create dibsection for 32-bit, 24-bit, or 15-bit (5-5-5). 
mJiDibSect = CreateDlBSection(0, (bitmapinfo *)&m_DibsectBmpinfo, 

DIB_RGB„COLORS, (void * *) (&ITL_pDi bSeCtBi ts) , NULL, NULL); 

Cm_hDibSect == null) 
{ 

// 

// Failed to create Dibsection! 

// 

DWORD ErrVal = GetLastError() ; 

TRACE("Error ! Dibsection picture buffer failed to initialize."); 
return false; 

el se 

{ 

// 

// Dibsection created successfully. Select into MemDC. 

m_hOl dDi bsect = (hbitmap) m _Di bSectMemDC . Sel ectob j ect (m„hDi bsect) ; 

// If 15/16 bit format, find actual RGB mask (5-5-5 vs 5-6-5). 
// 

m_Di bsect 555 = FALSE; 
if (m_BytesPerPixel == 2) 
{ 

// 

// Local struct gets pixel info. 
// 

struct LocalBMl 
{ 

bitmapinfoheader bi ; 
union 

{ 

RGBQUAD colors[256]; 
DWORD fields [256] ; 

}; 

}; 

LocalBMl pix_info; 

ZeroMemory(&pix_i nfo, sizeof (pix_info)) ; 
pix„info.bi .bisize = sizeof (pi x_i nfo. bi) ; 
pix_info.bi .biBitCount = 0; 

// First call fills in param fields. 
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// second call fills in mask fields. 
// 

GetDIBits(m_DibSectMemDC, m_hDibSect, 0, 1, NULL, 

(BITMAPINFO *)&pix_info, DIB_RGB_COLORS) ; 

GetDIBitsCm_DibSectMemDC, m_hDi bSect , 0, 1, NULL, 

(BITMAPINFO ")&pix_info, DIB_RGB_COLORS) ; 

if (pi x_i nf o. bi .bi Compression == 0) 

if (pix_info.bi .biBitCount > 8) 
{ 

i f (pi x_i nfo . bi . bi Bi tcount==16) 
m_DibSect555 = true; 

el se 



not get here\n") ; 

} 



} 

} 



{ 



return FALSE; 
} 



TRACE("More than 16 bits. Should 



el se 

{ 

TRACE("palettized. should not get here\n"); 
return false; 



else if (pix^info.bi .bicompression == bi__bitfields) 
{ 

DWORD all masks = pix_i nfo . fi elds [0] | pi x_i nfo.fi el ds[l] | 
pi x_info.fi elds [2] ; 

if (all masks == 0x7fff) 
m_DibSect555 = TRUE; 

} 

if (m_DibSect555 == true) 

{ // mdg: !!!!!!!!!!!! ! 

TRACE("video has init'd to 5-5-5 format! Capture functions may be 
much slower as a result."); 
} 

} 

} 

return TRUE; 

} 

char* cscreenimage: :GetScreenimage(int Srcx, int SrcY, int Width, int Height, int 
DestX, int DestY) 

// DWORD dwstart = GetTi ckCountO ; 

/- large_integer start; 

large_integer end; 

LARGE_INTEGER freq; 

QueryPerformanceCounter (&start) ; 

V 

// 

// Capture target area.-- DIBSection 

// 

m_DibSectMemDC. Fill Soli dRect(0, 0, m„CapWidth, truCapHei ght , RGB(0,0,0)); 

if (InuibsectMemDC.BitBlt (Destx, DestY, width, Height, &m_srcDC, SrcX, SrcY, 

SRCCOPY)) 

TRACE("Error %d\n", GetLastErrorO) ; 
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return NULL; 

} 

/* m_Total Frames++; 

// m_TotalTime += GetTi ckcount C) - dwStart; 

QueryPerformancecounterC&end) ; 
QueryPerformanceFrequency(&f req) ; 

m_TotalTime += (DWORD) ((end . Quad Part - start . QuadPart) * 1000 / 
(double)freq.QuadPart) ; 

// 

// Imprint cursor image on captured image. 



// 



POINT pt; 

GetCursorPos(&pt) ; 

hwnd hwnd = : :wi ndowFromPoint(pt) ; 



if (hwnd) 
{ 



FALSE) ) 



HCURSOR hCursor = NULL; 
DWORD pid; 

DWORD tid = GetwindowThreadProcessid(hwnd, &pid); 
if (tid != GetCurrentThreadldO) 

if (AttachThreadlnput(GetcurrentThreadld() , tid, TRUE)) 
{ 

hCursor = GetCursor(); 

if (!AttachThreadlnput(GetCurrentThreadld() , tid, 

ASSERT (FALSE) ; 



if (Ihcursor) 

hCursor = GetCursor() ; 

/* ICONINFO ii ; 

if (GetIconInfo(hCursor , &ii)) 
{ 

pt.x -= ii.xHotspot; 
pt.y -= ii .yHotspot; 

} 



/ 

*/ 
} 



in_DibSectMemDC.Drawlcon(pt.x, pt.y, hCursor); 



} 

return m^pDi bSectBits ; 



int cscreenimage: :cetsize() 
{ 

return m_Pi xel Buf Len ; 

} 
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CarToMux . c 

/* 

NAME: CarToMux. c 



PURPOSE : To define the interface between the Arctos Carousel 
process and the shared memory input to the Mux. 

DESCRIPTION: The Carousel process is concerned with 
creating and controlling shared memory input channels to 
the Mux and with supplying image bitmaps for processing by 
the Mux. 

The Mux is responsible for converting the bitmap into MPEG 
and sending the resulting frames according to how the 
channel is currently configured. 

This file defines how the carousel process controls the 
Mux input. 

All functions in this API are identified by the prefix 
'cm' which stands for "Carousel to Mux". 

NOTE : 

HISTORY : «MN0 Tim Lee. 

Copyright Sflt ' J V ictv, inc. All rights reserved. 



#include <wtypes.h> 
#include <winbase.h> 
finclude <winerror.h> 
#include <time.h> 
#include <stdio.h> 
#include "NumTypes.h" 
#include "SharedMem. h" 
#include "ictvMpeg.h" 
#include "ligoslib.h" 
#include "CarToMux. h" 



// #define CM_DUMP_TO_FlLE 1 

// Define this symbol for debugging to route output 
// to a data file instead of to shared memory. 

/* 

NAME : MUXSM 



PURPOSE: To identify the handle to the shared memory area 
for communicating mux-level commands. 

DESCRIPTION: This shared memory area is used for 
communicating with the Dynamic Manager of the mux. 

This shared memory area is opened by 'CmsetupO' which 
must be called before any other 'Cm' function is called. 

NOTE : 

history: ifllHfe Tim Lee 

_ */ 
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SM* MuxSM = 0; 

/* 

name: TheChannelList 



PURPOSE: To refer to the list of all existing channels. 

DESCRIPTION: When channels are added they are prepended to 
this list and when they are deleted they are removed from 
this list. 

NOTE : 

HISTORY: tfHf^Tim Lee 

*/ 

CrtiChannel* TheChannelList = 0; 

BOOL isAllOutputChannelsDisabled = 0; 

// Non-zero if output from all channels is disabled 

// or zero to allow individual channels to send 

// output according to their particular suspend/resume 

// status. 

// 

// Later as needed: gather this and any other 

// mux-specific attibutes into a mux status struct. 

/* _ 

name: cmOutputBuffer 



PURPOSE : To provide a standard place to put Ligos output. 

description: This buffer is allocated by cmsetupC). 

NOTE: Eventually this buffer will be replaced by code that 
directs Ligos output directly to a shared memory area. 

HISTORY: 12.15.99 Tim Lee 

I 

*/ 

u8* CmOutputBuffer = 0; 
u32 CmOutputBufferSize = 0; 

/* 

name: CmActivateAll 



PURPOSE: To enable output on all input channels that were 

suspended by a previous call to ' CmDeacti vateAl 1 () ' . 

description : only those channels that are individually 
marked as active are enabled for output. 

Always returns S_OK. 

EXAMPLE : 

Result = CmActivateAll O ; 

NOTE : 
assumes: 

Page 2 



CarToMux . c 



history : MM) Tim Lee 

12.15.99 Revised to disable/enable all output at 
the mux level rather than channel by 
channel . 

_ v 

// OUT: Result status code: 
// 

// S_OK 

s32 

CmActivateAll () 
{ 

bool ok; 
Muxcontrol c; 

// If the output channels are globally disabled. 
if( isAll OutputChannel sDi sabl ed ) 

// Fill in the mux control record for the activate, 
c. opcode ■ = MUX__ACTIVATE ; 
C.DebugLevel = 0; 

// Send an activate packet to the mux. 
ok = cmSendMuxCommandC MuxSM, &c, 0, 0 ); 

// Now output channels are not globally disabled. 
ISAllOutputChannelsDisabled = 0; 

} 

// Return success, 
return ( S_Ol< ) ; 

} 

/* 

NAME: CmActi vatechannel 



purpose: to enable output on an input channel to the Mux. 
DESCRIPTION: 

Returns the channel status, whether the channel is was 
removed (S_OK) or if the channel doesn't exist to be resumed 
(E^NO^CHANNEL) . 

EXAMPLE : 

Result = 

CmActivateChannel ( 
"Bis", // Prefix used to one group of channels 
// from another. 
// 

207 ); // virtual channel number. 

NOTE: 
ASSUMES : 

HISTORY: WKKK/k Tim Lee 

iHIHm Finished. 
V 

// OUT: Result status code: 
// 

// S_OK 
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// E_NO_CHANNEL 

S32 

CmActivateChannel ( 

s8- Prefix, // A three letter zero-terminated 

// string used to identify a group of 
// related channels, eg. "Bis". 

u32 Channel )// A small decimal number used to 

// identify a specific channel in a 
// group defined by the prefix. 

// This is a "virtual channel number" 
// in Gi's terms. 



{ 



CmChannel* A; 
BOOL ok; 

// search the channel list for an existing channel with 
// the same prefix and virtual channel number. 
A = CmFindChannel ( Prefix, Channel ); 

// If the channel exists, 
if C A ) 

{ 

// If the channel is not active. 
if( A->lsActive == 0 ) 

// Mark this channel as active. 
A->IsActive = 1; 

// Send an activate packet to the channel, 
ok = cmsendchannel command C 

A, CHANNEI ACTIVATE , 0, 0 ); 

//if the command was acknowledged. 

if( ok ) 

{ 

// Return OK status. 

return ( S_Ol< ) ; 

} 

else // Not acknowledged. 

// Return failure. 
returnC E„NO_CHANNEL ); 

} 

} 

else // Channel is already active. 
{ 

// Return OK status, 
return ( S_OI< ) ; 

} } 

else // The channel doesn't exist. 

{ 

// Return the error code. 
returnC E„NO_CHANNEL ); 

} 



NAME : CmAddChannel 
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PURPOSE : To add a carousel input channel to the Mux. 

description : Create all the mux resources necessary to for 
a new channel but doesn't enable the output: output is 
enabled by calling ' CmActivateChannel 0 ' . 

Returns the memory location of the bitmap buffer where 
images should be placed for output. Also returns the 
channel status, whether the channel is new (s_OK) , already 
existing (E_CHANNEL_EXISTS) or unable to be used 
(E_INVALID_CHANNEL) . 

EXAMPLE : 

// Declare a channel specification structure. 
Cmchannelspec c; 

// Fill in the channel specification structure. 

// Assign a prefix used to distinguish one group 

// of channels from another. 

CPrefix[0] = ' B ' ; 

C.Prefix[l] = 'i 1 ; 

C. prefix [2] = 's' ; 

C.Prefix[3] = 0; 

// Assign a virtual channel number. 
C.Channel = 207; 

// Assign the program ID number to be used in the 
// PAT/PMT. 

C.Prog = 42; 

// set the encoding bit rate to 5 megabits. 
CEncodingBitRate = 5000000.0; 

// Set the channel bit rate to 50l< bits. 
C.ChannelBitRate = 50000.0; 

// Set the presentation frame rate to 29.97 frames 
// per second. 
C.Hz = 29.97; 

// Assign an ES PID number of 17. 
C.PID = 17; 

// Assign a PMT PID number of 18. 
c.pmt = 18; 

// set the pixel row count to 480 rows. 
c.RowCount = 480; 

// set the pixel column count to 640 columns. 
C.ColCount = 640; 

// Set the pixel type to the only type that Ligos 
// supports. 

C.PixelType = cmRGB565; 

// Add the channel to the mux. 
Result = CmAddChannel C &c ); 

NOTE: 
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I ASSUMES : 

I .- 

I history: MH^WTim Lee 

I flHMWAdded opening of shared memory area. 

// OUT: Result status code: 

// 

// S_OK 

// E_CHAN N E L_EXI STS 
// E_INVALID_CHANNEL 

s32 

CmAddChannel ( CmChannel Spec* C ) 
{ 

Cmchannel * A; 

s8 Name [30]; 

u32 BufferSize; 

BOOL ok; 

MuxControl X; 

// search the channel list for an existing channel with 
// the same prefix and virtual channel number. 
A = CtnFindChannel ( C->Prefix, C->Channel ); 

// if the channel already exists. 
|f C A ) 

// Return the result code for an existing channel. 
returnC e_channel_exists ); 

} 

// validate the channel parameters here and reject 

// bad input with an error. 

if( CmlsGoodChannelSpecC C ) == 0 ) 

{ 

// Return the failure code, 
return ( E_INVALID_CHANNEL ); 

} 

// 

// At this point we have a valid channel add request 
// that doesn't duplicate any existing channel. 
// 

// Fill in a mux control record. 

X. Opcode = CHANNEI MAKE ; 

x.inputunitType = SHM_ENC; 
x.config[0] = 0; 

x. Prefix [0] = C->Prefix[0] 

x. Prefix [1] = c->Prefix[l] 

X.Prefix[2] = C->Prefix[2] 

X.Prefix[3] = C->Prefix[3] 

X.Channel = C->Channel ; 

x.Prog = C->Prog; 

X. EncodingBitRate = c->EncodingBitRate; 

X. Channel BitRate = C->ChannelBitRate; 

X.Hz = C->Hz; 

X.PID = C->PID; 

X.PMT = C->PMT; 

x.DebugLevel = 0; 

// Request the creation of a new ShmEnc encoder by 
// the Mux. 
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ok = cmsendMuxcommandC 

MuxSM, // Address of an open shared memory 
// area read by the Dynamic Manager 
// of a mux or by one of the input 
// units (encoders) of the mux. 
// 

&X, // Address of a mux control record. 

0, // Any other input data require by 

// the command. Use zero if there is 
// no other data, this data must be 
// in ictv MPEG Packet format. 

0 ); // How many bytes of additional data 

// should be appended to the channel 
// control record. 

ok = 1; // For now the mux will have a pre-defined list of channels 

// if the mux could not add the new channel. 

ifC ok = 0 ) 

{ 

// Return the error code. 
returnC E_INVALID_CHANNEL ); 

} 

// Make a new record for an existing channel. 
A = (CmChannel *) mallocC sizeofC CmChannel ) ); 

// Copy the channel spec to the channel record. 
A->C = *C; 

// Mark the channel as inactive initially. 
A->IsActive = 0; 

// Make a name for the shared memory area by 
// combining the prefix with the channel number. 
sprintfC Name, "%s%d", C->Prefix, c->Channel ); 

// calculate the size of the shared memory area: 
// always use 128 K for now. 
BufferSize = 128 * 1024; 

// Make the shared memory area for the channel . 

A~>S = 

OpenSMC 

Name, // The name of the shared memory area, 
// a zero-terminated ASCII string up 
// to 250 bytes long. 
Buffersi ze ) ; 

// The size of the shared memory area 
// i n bytes . 

// Prepend channel record to the list of all channels. 

// - 

ResetEvent(A->s->DataEvent) ; 

// if there is already a channel in the list. 

if( Thechannel Li st ) 

{ 

// Change the prior link of the current first record 
// in the list to point to the new record. 
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} 



TheChannel List->Prior = A; 



// Connect the forward link from A to the existing first 
// record in the list or zero if there is no other record. 
A->Next = TheChannelList; 

// Make 'A' the first record in the list. 
TheChannelList = A; 
A->Prior = 0; 

// Return the success code, 
return ( S_Ol< ) ; 



NAME: CmFi ndChannel 



PURPOSE : To find an existing channel in the list of all 
channel s . 



DESCRIPTION: 
EXAMPLE : 
C = 



NOTE: 

assumes: 

HISTORY: 



CmFi ndchannel ( 
"Bis", // Prefix used to one group of channels 
// from another. 

// 

207 ); // virtual channel number. 



•Tim Lee 



*/ 

// OUT: The address of a CmChannel record 
// ' ' 

// 



or zero if record not found. 



CmChannel * 
CmFi ndchannel ( 

58* 



u32 



Prefix, // A three letter zero-terminated 

// string used to identify a group of 
// related channels, eg. "Bis". 
// 

channel )// A small decimal number used to 

// identify a specific channel in a 
// group defined by the prefix. 

// 

// This is a "virtual channel number" 
// in Gl's terms. 

CmChannel* A; 

// Refer to the first channel record in the list. 
A = TheChannelList; 

// While there is a channel record. 

whileC A ) 

{ 

// If the channel number matches the desired 
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// channel . 

if( A->C. Channel ===== Channel ) 

// if the prefix matches the desired prefix. 

ifC C A->c.Prefix[0] == Prefix[0] ) && 
C A->C.Prefix[l] == Prefix[l] ) && 
( A->C.Prefix[2] ===== Prefix[2] ) ) 

// Return the address of the channel 
// record. 
returnC A ) ; 



// Advance to the next record. 
A = A->Next; 

} 

// Record was not found. Return zero. 
returnC 0 ) ; 



name : CmDeactivateAll 



PURPOSE: To disable output on all active input channels. 

DESCRIPTION : Only those channels that are currently active 
at the time of this call are will be enabled on a subsequent 
call to 'CmActi vateAll O ' . 

Always returns S_OK. 

example: 

Result = CmDeactivateAll () ; 

NOTE : 
ASSUMES : 

HISTORY: WBKKHk Tim Lee 

12.15.99 Revised to disable/enable all output at 
the mux level rather than channel by 
channel . 

v 

// out: Result status code: 
// 

// S_OK 

s32 

CmDeacti vateAl 1 () 
{ 

BOOL ok; 
MuxControl C; 

// if the output channels are not globally disabled. 

if( isAlloutputchannelsDisabled ===== 0 ) 

{ 

// Fill in the mux control record for the activate. 

C. OpCode = MUX_DEACTIVATE; 

C.DebugLevel = 0; 

// send an activate packet to the mux. 
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ok = CmSendMuxCommandC MuxSM, &c, 0, 0 ); 



// Now all output is globally disabled. 
isAllOutputchannelsDisabled = 1; 



} 



// Return success, 
return ( s„Oi< ) ; 



NAME: CmOeacti vatechannel 



purpose: To disable output on a channel going into the Mux. 

DESCRIPTION: 

Returns the channel status, whether the channel is was 
removed (s„OK) or if the channel doesn't exist to be resumed 

(E_NO_CHANNEl) . 
EXAMPLE : 

Result = 

CmDeacti vatechannel ( 
"Bis", // Prefix used to one group of channels 
// from another. 
// 

207 ); // Virtual channel number. 

NOTE: 

ASSUMES : 

history : flBMMI Tim Lee 



// OUT: Result status code: 
// 

// S_OI< 

// E_NO_CHANNEL 



S32 

CmDeacti vatechannel ( 

58* Prefix, 



// A three letter zero-terminated 

// string used to identify a group of 

// related channels, eg. "Bis". 

// 

u32 channel )// A small decimal number used to 

// identify a specific channel in a 

// group defined by the prefix. 

// This is a "virtual channel number" 

// in GI's terms. 



CmChannel * 
BOOL 



a; 
ok ; 



// search the channel list for an existing channel with 
// the same prefix and virtual channel number. 
A = cmFi ndchannel ( Prefix, Channel ); 



// If the channel exists, 
if C A ) 

{ 



Page 10 



CarToMux. c 

// if the channel is active, 
i f ( A->lsActive ) 

// Mark this channel as inactive. 
A->lsActive = 0; 

// Send an deactivate packet to the channel, 
ok = CmSendChannel Command ( 

A, CHANNEI DEACTIVATE , 0, 0 ) 

// if the command was acknowledged. 

if( ok ) 

{ 

// Return OK status. 

return ( S_OK ) ; 

} 

else // Not acknowledged. 

{ 

// Return failure. 
return( EJJO^CHANNEL ); 

} 

} 

// Return OK status, 
return ( S_OK ) ; 

} 

else // The channel doesn't exist. 
{ 

// Return the error code, 
return ( e_no_channel ); 

} 



NAME: CmlsGoodChannel Spec 



purpose: To test if a channel specification record contains 
values that are within bounds. 

description: Returns 1 if all the fields within the channel 
specification are valid, else returns 0. 

NOTE : 

I HISTORY: iHHM^Tim Lee 

I v 

BOOL 

CmlsGoodChannel Spec( CmChannel Spec- C ) 
{ 

// If the three letter channel prefix is not an ASCII 

// letter or the string terminator is missing. 

if( ! isASCHLetterC C->Prefix[0] ) |j 

UsASCiiLetterC c->Prefix[l] ) I I 

UsASCllLetterC c->Prefix[2] ) | | 

C->Prefix[3] != 0 ) 

{ 

// Return code for invalid. 
returnC 0 ) ; 

} 

// if the Channel number is out of bounds. 
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if( C->Channel < 1 || C->Channel > 4095 ) 
{ 

// Return code for invalid. 
return( 0 ) ; 

} 

// If the Program number is out of bounds. 
if( c->Prog < 1 | I C->Prog > 65535 ) 

// Return code for invalid. 
returnC 0 ) ; 

} 

// If the encoding bit rate is out of bounds. 
if( c->EncodingBitRate < 1000000.0 M 
c->EncodingBitRate > 10000000.0 ) 

// Return code for invalid. 
returnC 0 ) ; 

} 

// if the channel bit rate is out of bounds. 
if( C->ChannelBitRate < 10000.0 || 
C->ChannelBitRate > 10000000.0 ) 

// Return code for invalid. 
returnC 0 ) ; 

} 

// if the output frame rate is invalid. 
if( c->Hz != ((f64) 23.976) && 
C->Hz != C(f64) 29.97) ) 

{ 

// Return code for invalid, 
return ( 0 ); 

} 

// If the PID is out of bounds, 
if ( C->PID < 16 | | C->PID > 8190 ) 

{ 

// Return code for invalid. 
returnC 0 ) ; 

} 

// If the PMT is out of bounds, 
if C C->PMT < 16 | | C->PMT > 8190 ) 

{ 

// Return code for invalid. 
returnC 0 ) ; 

} 

// If the pixel row count is not supported. 

ifC 0>RowCount != 480 ) 

{ 

// Return code for invalid. 
returnC 0 ) ; 

} 

// if the pixel column count is not supported. 
ifC C->Col Count != 640 ) 

// Return code for invalid. 
returnC 0 ) ; 
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} 



} 

/* 



// If the pixel type is not supported. 
if( c~>PixelType != cmRGB565 ) 

// Return code for invalid. 
returnC 0 ) ; 

} 

// if a pixel buffer is given but it has 
// no size. 

if( c->Buffer && c->Datasize == 0 ) 

// Return code for invalid. 
returnC 0 ) ; 

} 

// otherwise, the record is valid. 
returnC 1 ) ; 



NAME: CmRemovechannel 



PURPOSE: to remove a carousel input channel from the Mux. 

description : stops transmitting data and deallocates all the 
resources assigned to the channel. 

Returns the channel status, whether the channel is was 
removed (s_OK) or if the channel doesn't exist to be removed 
(E_NO_CHANNEL) . 

EXAMPLE: 

Result = 

CmRemovechannel ( 
"Bis", // Prefix used to one group of channels 
// from another. 



// 

207 ); // virtual channel number. 



NOTE: 

assumes: 

HISTORY: 



Tim Lee 



s32 

CmRemovechannel ( 



// OUT: Result status code: 
// 

// S_OK 

// E„NO_CHANNEL 



Prefix, // A three letter zero-terminated 

// string used to identify a group of 
// related channels, eg. "Bis". 

// 

u32 Channel )// A small decimal number used to 

// identify a specific channel in a 
// group defined by the prefix. 

// 

// This is a "virtual channel number" 
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{ 

CmChannel* A; 
BOOL ok; 

// Search the channel list for an existing channel with 
// the same prefix and virtual channel number. 
A = cmFi ndchannel ( Prefix, channel ); 

// if the channel exists. 

ifC A ) 

{ 

// 

// Extract the channel record from the channel list. 
// 

// if there is a record prior to A in the list. 
if( A->Prior ) 

// Link the prior record to the record after A. 
A->Pri or->Next = A->Next; 

} 

// if there is a link after A in the list. 

if( A->Next ) 

{ 

// Link the next record back to the record 
// before A. 

A->Next->Prior = A->Prior; 

} 

// if A is the first record in the list. 

if( TheChannel List == A ) 

{ 

// Refer the list to the next record. 
TheChannel Li st = A->Next; 

} 

// Request the deletion of an existing encoder 
// by the Mux. 
ok = CmSendChannelCommandC 
A, 

CHANNEL_DELETE , 

o, 

0 ); 

// close the shared memory area. 
closeSMC A->s ) ; 

// Free the channel record, 
f ree( A ) ; 

// Report successful channel removal . 
return ( S_OK ) ; 

} 

else // The channel doesn't exist. 
{ 

// Return the status code saying that there is no 
// channel with the given prefix and channel number, 
return ( E„NO„CHANNEL ); 

} 

} 
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PURPOSE: to send a channel control command to a mux input 
channel . 

description : Returns one if the command was sent and 
acknowledged by a mux input channel or returns zero if 
the timeout period for the shared memory channel elapses. 



EXAMPLE : 



ok = Cmsendchannel Command ( 
A, 

CHANNEI ACTIVATE , 

o, 

0 ); 



NOTE : 
ASSUMES : 
HISTORY: 



Tim Lee from 'sendDataSM' 



BOOL 

Cmsendchannel Command ( 
CmChannel * 

u32 



u32 



A, // Address of an existing channel record. 

// 

Opcode, 

// Channel command code: see Mux control 
// opcodes in "ictvMpeg . h" . 

// 

OpData, 

// Any other input data require by 
// the command. Use zero if there is 
// no other data. 

// 

opDatasize ) 

// How many bytes of additional data 
// should be appended to the channel 
// control record. 



CmChannel Spec* 
Muxcontrol 

BOOL 
u32 

SM* 



s; 



c; 
ok; 



DataSize, Packetsize; 

M; 



// Calculate the overall size of the data portion 
// of the Share Memory Packet. 
DataSize = 

sizeofC PacketHeaderIM ) 

// For the control packet header. 

+ 

sizeofC Muxcontrol ) 

// The size of the control packet data. 

+ 

OpDatasize; 

// The size of any additional data tacked 
// on the end. 

// calculate the total size of the shared Memory 
// packet in bytes. 
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Packetsize = sizeof( packetHeaderSM ) + DataSize; 

// Refer to the shared memory area of the channel 
// as ' M ' . 
M = A->S; 

// if the given data size exceeds the size of the 

// shared memory buffer. 

if( Packetsize > M->BufferSi ze ) 

{ 

// Return failure. 
return( 0 ) ; 

} 

// Set the opcode field in the control record. 
C. Opcode = Opcode; 

// Treat the encoder type as shared memory. 
C.InputUnitType = SHM_ENC; 

// Clear the configuration string. 
C.Config[0] = 0; 

// Don't enable debuggin. 
C.DebugLevel = 0; 

// Refer to the channel spec record of the channel 
// record. 

S = &A->C; 

// Copy the channel specification to the 
// channel control record. 
C.Prefix[01 = s->Prefix[0] 

C.Prefix[l] = S->Prefix[l] 

C.Prefix[2] = S->Prefix[2] 

C.Prefix[3] = S->Prefix[3] 

C.Channel = s->Channel ; 

c.Prog = s->Prog; 

C. EncodingBitRate = s->EncodingBitRate; 
c. channel BitRate = S->Channel Bi tRate ; 
C.Hz = S->Hz; 

CPID = S->PID; 

C.PMT = S->PMT; 

// Send the data to the channel input buffer. 

ok = cmSendMuxcommandC M, &c, OpData, OpDatasize ); 

// Return the status of the send. 
returnC ok ) ; 



NAME: CrnSendMuxCommand 



purpose: To send a control command to a mux or input 
channel . 

DESCRIPTION: Returns 1 if the command was sent and 
acknowledged or returns 0 if the timeout period for the 
shared memory area elapses. 

EXAMPLE: 

page 16 



CarToMux . c 



ok = cmsendMuxcommandC 

MUXSM, 

&c, 

MUX_ACTIVATE , 
0, 

0 ); 



NOTE : 
ASSUMES : 

history: 



Tim Lee from ' SendDataSM' 



-V 



BOOL 

CmSendMuxCommand ( 

SM* M , 



MuxControl" C, 



opData, 



// Address of an open shared memory 
// area read by the Dynamic Manager 
// of a mux or by one of the input 
// units (encoders) of the mux. 
// 

// Address of a mux control record. 

// 

// Any other input data require by 
// the command, use zero if there is 
// no other data. THis data must be 
// in Ictv MPEG Packet format. 



u32 



{ 



opoatasize ) // how many bytes of additional data 

// should be appended to the channel 
// control record. 



u8* AtData; 
BOOL ok; 
u32 Datasize, Packetsize; 

PacketHeaderSM* H; 
PacketHeaderIM* K; 
#ifdef CM_DUMP_TO_FILE 

static u8* PacketBuffer = 0; 

static u32 PacketBufferSi ze = 0; 

// if the shared memory space is not yet redirecting 

// output to a file. 

if( ! M->IsSendToFi 1 elnstead ) 

{ 

// Then turn on redirection to a file. 
M->lssendToFileinstead = 1; 

} 

#endif // cm_dump_to_file 

// Calculate the overall size of the data portion 
// of the Shared Memory Packet. 
Datasize = 

sizeofC PacketHeaderIM ) 

// For the control packet header. 

+ 

sizeofC Muxcontrol ) 

// The size of the control packet data. 

+ 

OpDataSi ze ; 

// The size of any additional data tacked 
// on the end. 
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// calculate the total size of the shared Memory 
// packet in bytes. 

PacketSize = sizeof( PacketHeaderSM ) + Datasize; 

#ifdef CM_DUMP_TO_FILE 

// If the packet size exceeds the current size of 

// the packet buffer. 

if( PacketSize > PacketBuff erSi ze ) 

// If there is a current packet buffer. 

ifC PacketBuff er ) 

{ 

// Free it. 

free( PacketBuff er ); 

} 

// Allocate a new packet buffer. 
PacketBuffer = (u8*) mallocC PacketSize ); 
PacketBuff erSi ze = PacketSize; 

} 

// Refer to the first byte of the packet data 
// field. 

AtData = PacketBuffer; 



// Build a mux channel control packet. 
// 

// Refer to the data as an ictv MPEG packet 
// header. 

K = (PacketHeaderiM*) AtData; 

// Lay down an Ictv MPEG Packet header in 

// the working buffer. 

K->ID = packet_id_mux_control; 

// Fill in the packet length field, most 
// significant byte first. 

!<->SizeA = Cu8) C sizeofC Muxcontrol ) » 16 ) ; 
K->SizeB = (uS) C sizeofC Muxcontrol ) » 8 ); 
K->SizeC = Cu8) sizeofC Muxcontrol ); 

// Advance to the first byte of the control 

// packet data field. 

AtData += sizeofC PacketHeaderiM ) ; 

// Append the mux control record to the working 
// buffer. 

memcpyC AtData, Cu8*) C, sizeofC Muxcontrol ) ); 

// Account for the data added to the working buffer. 
AtData ■+= sizeofC Muxcontrol ) ; 

// if there is any additional data following the channel 

// control record: the additional data must be 

// ictv MPEG Packet format. 

ifC OpDataSize ) 

{ 

// Then append the additional data. 
memcpyC AtData, OpData, OpDataSize ); 
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// Account for the data added on. 
AtData += opoatasize; 

} 

// Then send the packet to the output file, 
ok = 5endDataSM( m, PacketBuffer, DataSize ); 

#else // ! CM_DUMP_TO_FILE 

// If the given data size exceeds the size of the 
// target shared memory buffer. 
if( Packetsize > M->BufferSize ) 

// Return failure. 
return( 0 ) ; 

// wait until any data currently in the buffer has been 
// consumed by another party, 
ok = waitForNoDataSMC M ); 

// If there is no data currently in the buffer, 
if C ok ) 

// wait for exclusive access to the shared memory 
// area. 

ok = Begi nAccessSMC M ); 

// if exclusive access has been acquired before 
// the time out period, 
if C ok ) 

// Refer to the first byte of the shared 
// memory area as a PacketHeaderSM. 
H = (PacketHeaderSM-) M->Buffer; 

// Copy the size to the first four bytes. 
H->Size = Datasize; 

// Refer to the first byte of the packet data 
// field. 

AtData = M->Buffer + sizeof( PacketHeaderSM ); 



// Build a mux channel control packet. 
// 

// Refer to the data as an Ictv MPEG packet 
// header. 

K = (PacketHeaderlM-'O AtData; 

// Lay down an Ictv MPEG Packet header in 

// the working buffer. 

K->ID = PACKET_ID_MUX„CONTROL ; 

// Fill in the packet length field, most 
// significant byte first. 

K->sizeA = (u8) ( sizeofC Muxcontrol ) » 16 ) ; 
K->SizeB = (u8) ( sizeofC Muxcontrol ) » 8 ); 
K->SizeC = (u8) sizeofC Muxcontrol ); 

// Advance to the first byte of the control 
// packet data field. 
AtData += sizeofC PacketHeaderlM ); 
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} 

} 

#endif // CM_DUMP„TO„FILE 

// Return the status of the send. 
returnC ok ) ; 

} 
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// Append the mux control record to the working 
// buffer. 

memcpyC AtData, (u8*) C, sizeof( MuxControl ) ); 

// Account for the data added to the working buffer. 
AtData += sizeofC MuxControl ); 

// if there is any additional data following the channel 
// control record: the additional data must be 
// Ictv mpeg Packet format. 
if( OpDataSize ) 

// Then append the additional data. 
memcpyC AtData, OpData, OpDataSize ); 

// Account for the data added on. 
AtData += OpDataSize; 



// Mark the presence of the data. 
HerelsDataSM( M ) ; 

// Release the shared memory area. 
EndAccessSM( M ) ; 

// Wait until the data just put into the buffer 
// is consumed by another party, 
ok = WaitForNoDataSMC M ); 



/* 

NAME: CmSetup 



PURPOSE : To setup the Carousel-to-mux interface. 

DESCRIPTION: 
NOTE: 

HISTORY: tfHI Tim Lee 



BOOL 

CmSetupO 

u32 BufferSize; 

// calculate the size of the Mux shared memory area: 
// always use 128 K for now. 
BufferSize = 128 * 1024; 

// Open the shared memory channel to the mux. 

MUXSM = 
OpenSM( 
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"muxsm", // The name of the shared memory area, 
// a zero-terminated ASCII string up 
// to 250 bytes long. 
BufferSi ze ) ; 

// The size of the shared memory area 
//in bytes. 

// Allocate a buffer for Ligos output, also 128K. 
CmOutputBuffer = (u8*) mallocC BufferSi ze ); 
CmOutputBufferSi ze = BufferSi ze; 

// Return success. 
return( 1 ) ; 

} 



NAME: cmupdateChannel 



PURPOSE : To update the channel parameters and/or send 
a new image bitmap. 

DESCRIPTION : 

To send a new image through the channel, copy the bitmap 
to the buffer addressed by the "Buffer" field within 
the ' cmchannel spec ' record. 

use zero for the 'Buffer' field of the channel spec if no 
image data should be sent. 

Returns the channel status, S_OK if the update was sucessful 
or E_INVAI_ID_PARAM if not. 

EXAMPLE : 

// Declare a channel specification structure, 
cmchannel Spec C; 

// call 'cmAddchannel () ' here somewhere to make the 
// channel for "Bis" 207. 

// Then later copy an image bitmap to the input buffer. 
memcpyC c. Buffer, Mylmage, si zeofMyimage ); 

// Then call ' CmupdateChannel () 1 to transmit the new image. 
Result = CmupdateChannel ( &C ) ; 

NOTE; TBD: It remains to be determined which channel 
attributes can be changed after it is created. 

ASSUMES: 

HISTORY : ■MHfeTim Lee 

12.15.99 Put in Still Frame packet header. 



// OUT: Result status code: 

// 

// S_OK 

// E_INVALID_PARAM 

532 

CmupdateChannel ( Cmchannel Spec- C ) 
{ 
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CmChannel* A; 
cmchannelspec- d; 
bool ok; 
u32 FrameSize; 

// Search the channel list for an existing channel with 
// the same prefix and virtual channel number. 
A = CmFindchannel ( c->Prefix, c->channel ); 

// If the channel exists, 
jf C A ) 

// If the channel parameter specification is valid. 
if( cmlsGoodChannelspecC c ) ) 

// Refer to the currently active channel parameters 
//as 1 D ' . 
D = &(A->C) ; 

// if any of the channel parameters are different. 



= c->Prog ) 
= c->EncodingBitRate ) 
= C->Channel BitRate ) 
= C->Hz ) 
= C->PID ) 
= C->PMT ) ) 



if( ( D->Prog 

C D->EncodingBitRate 
C D->Channel BitRate 
C D->HZ 
( D->PID 
( D->PMT 

// Send an update packet to the channel . 

ok = CmSendChannel Command ( A, CHANNEL_UPDATE , 0, 



// update the current channel parameters. 
D->Prog = c->Prog; 

D->EncodingBitRate = C->EncodingBitRate; 
D->Channel BitRate = C->Channel BitRate ; 
D->Hz = C->hz; 

D->PID = C->PID; 

D->PMT = C->PMT; 

} 

else // No channel parmeters changed. 
{ 

// Treat the change status as OK. 
ok = 1; 

} 

// if there is an image to send. 

if( C->Buffer ) 

{ 

// Call the Ligos encoder to encode the image: 

// the returned data is already in Ictv MPEG 

// Packet format, specifically a Still Frame Packet. 

FrameSize = 

Encode_Frame( 

C->Buffer, 

CmOutputBuffer ) ; 

// Fix this. Causes ligos to flush the previous frame. 
FrameSize = 
Encode_Frame( 

C->Buffer , 

CmOutputBuffer ) ; 
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// send the Still Picture packet to the channel with 



} 

I'- 



ll channel prefix packet. 
// 

// TBD : Later on grab the shared memory buffer 
// and use that area as the output of the 
// Ligos encoder to reduce memory movement, 
ok &= CmSendChannelCommandC 
A, 

CHANNEL_DATA, 
CmOutputBuffer , 
Framesize ); 

} 

// if all executed commands were acknowledged. 

if( ok ) 

{ 

// Return OK status. 

return ( S_OK ) ; 

} 

else // Not acknowledged. 
{ 

// Return failure. 

return ( E_INVALID„PARAM ); 

} 

} 

else // Bad channel spec. 
{ 

// Return failure. 

return ( e_invalid_param ); 

} 

} 

else // Channel doesn't exist. 
{ 

// Return failure. 

return ( E_INVALID_PARAM ); 

} 



name : isASCHLetter 



purpose : To test if a character value is an ASCII letter. 

DESCRIPTION: Returns 1 if the character is a letter or 0 
if it isn't. 

EXAMPLE : 
NOTE : 
ASSUMES: 

history: 

12.15.99 From 1 TLAsci i . c ' . 

_ V 

BOOL 

isASCULetterC u32 c ) 

// if the given character is either an lower or upper 
// case letter. 

if C C C >= 'a' && C <= 'z') || 
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( C >= 'A' && C <= 'Z') ) 
{ 

return (1) ; 

} 

else // Not a letter. 
{ 

returnC 0 ) ; 

} 

} 
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ChannelMngr . cpp 

// ChannelMngr. cpp: implementation of the CChannelMngr class. 

////////////////////////////////////////////////////////////////////// 

#include "stdafx.h" 
#include "carousel explorer . h" 
#include "ChannelMngr . h" 
#include "cchannel Map . h" 

#include "channel. h" 
#include "StatusFrm . h" 
#include "Channel MapFrm . h" 
#include "screenlmage . h" 

#i ncl ude " . . \Al ertManager\Al ertwanage r Exports . h" 

#ifdef _DEBUG 
#undef THIS_FILE 

static char THIS_FILE[]= FILE 

#define new debug„new 
#endif 

#define QUEUE_THREAD_TIMECjUT 10000 

///////////////////////////////////////////////////////////////////////////// 
// State Machine 

#define sm_class CChannelMngr 
BEGIN_SM_MAP(CChannelMngr) 

/* ST_INACTIVE 
ST_^CTIVE 

ST_DEACTIVATING 
/* 



/* SE_ACTIVATE 



/* SE_DEACTIVATE */ NO_OP , 

DO(ST_DEACTIVATlNG , OnDeacti vate) , 



V NO_OP, 



V do(st_active, onActivate), 

NO^OP , 



NO_OP , 



do^ns (OnDeacti vate) 



/" SE_DEACTIVATED 
NO_OP , 

DO(ST_lNACTIVE, OnDeacti vated) , 
/* SE_CHANNEL_CREATED "/ NO_OP , 

DO_NS(OnChannel Created) , 
/* SE_CHANNEL_DESTROYED "/ NO_OP , 

DO_NS(OnChannel Destroyed) , 

/* SE„ENCODE_CHANNEL */ NO_OP, 

DO_NS(OnEncodeChannel ) , 
/* SE_ADMIN_CMD 

DO_NS(onAdmincommand) , 
END_SM_MAP() ; 

BEGIN_IPCTOSM_MAP (CChannelMngr) 
END_IPCTOSM_MAP() ; 

////////////////////////////////////////////////////////////////////// 
// Construction/Destruction 

////////////////////////////////////////////////////////////////////// 



DO_NS(OnRemovechannel) , 
DO_NS(OnRemoveChannel) , 



NO_OP , 

*/ DO_NS(OnCancel AdminCommand) , 

DO_NS(OnCancelAdmi nCommand) , 



CChannelMngr: : CChannelMngr () 

: m_captureQueuesemaphore(0, Oxff) 
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m_hcaptureThread = null; 
mJiHotFolderThread = NULL; 
m_bQuit = FALSE; 
m_nDeacti vateCounter = 0; 

} 

CChannelMngr: :~cchannelMngr() 

{ 

} 

I -v -v v? * * it it it it it it it it it it i; it it it it it it it it it it it it it it it it it ic it it it it it it it it V? i; it it it i: it it it it it it it it it it it it it it it it it it i: it it it it it it it it it it it 
it 

* state Machine virtuals 

it it it it it * * 1i it it * * * * * * it it it * * * * * * * * * * it it it it it it it it it it it it it it it it it it it it it it * * * it it it it it it it it it it it it it. it it it it it it it it it it it J 

void CChannelMngr : :OnPreCreate(IPCSM_CREATE_STRUCT"' cs) 
{ 

cs->dwQueueSi ze = Oxffff; 
cs->dwDataSi ze = 0; 

} 

int CChannelMngr: :Onlnitlnstance() 
{ 

return IQE__SUCCESS ; 

} 

* state Machine Actions 

void CChannelMngr : :OnActi vate(LPARAM iParaml, LPARAM lParam2) 

theApp . Log (ARCTOS_EVENT , ARCTOS_CE_ACTIVATE) ; 

m_bQuit = FALSE; 

// Load the channel map 
if ( ! LoadChannelMapO) 

Fi reEvent (SE_DEACTIVATE) ; 
return ; 

} 

// Create the capture thread 
DWORD dwThreadld; 

m„CaptureQueueHeartbeat = GetTi ckCountO ; 

m_hCaptureThread = create~rhread(NULL , 0, CaptureQueueThreadProc , this, 0, 
&dwThreadId) ; 

ASSERT(mJiCaptureThread) ; 

// Create the hotfolder thread 

m_hHotFol derrhread = create~rhread(NULL , 0, HotFolderThreadProc, this, 0, 
&dwThreadId) ; 

ASSERT(m_hHotFolderThread) ; 

// start the watchdog thread 

m_hwatchdogThread = CreateThread(NULL, 0, WatchdogThreadProc, this, 0, 
&dwThreadld) ; 

ASSERT(m_hWatchdogThread) ; 
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} 

void CChannelMngr: :OnDeacti vate(LPARAM lParaml, LPARAM lParam2) 

{ 

m_bQuit = TRUE ; 

// Close the hot folder thread 

if (mJiHotFolderThread) 

{ 

// The user has quit - clean up 

if (wait_jtmeout == Wai tForSi ngl eOb j ect (m_hHot Fol derTh read , 5000)) 
{ 

Termi nateThread(m„hCaptureThread , false) ; 
theApp . Log (arctos_event_warning , 
arctos_ce_err_terminate_thread, l, "hot folder") ; 

} 

CloseHandl e(m_hHotFol derThread) ; 
mJiHotFolderThread = NULL; 

} 

// close the watchdog thread thread 
if (mJiWatchdogThread) 

{ 

// The user has quit - clean up 

if (WAIT_TIME0UT == WaitForSingleObject(m_hWatchdogThread, 5000)) 
{ 

Termi nateThread(m_hWatchdogThread , false) ; 
theApp . Log (arctos_event_warning , 
ARCTOS_CE_ERR_TERMINATE_THREAD, 1, "watchdog"); 

} 

CloseHandl e(m_hwatchdogThread) ; 
mJiWatchdogThread = NULL; 

} 

// close the update thread 
if (m_hCaptureThread) 
{ 

// The user has quit - clean up 

if (wait_timeout — wai tForsi ngl eobj ect (m_hcaptureTh read, 5000)) 
{ 

Termi nateTh read (mJicaptureTh read, false) ; 
theApp . Log (arctos_event_warning , 
arctos_ce_err_terminate_thread, 1, "capture"); 

} 

CloseHandle (mJicaptureTh read) ; 
m_hcaptureThread = NULL; 

// Clean up the capture queue and reset the semaphore 

CSingleLock 1 ock(&m_CaptureQueueMutex , TRUE); 

while (WaitForSingleObject(m_CaptureQueueSemaphore, 0) == 

WAIT_OBJECT_0) ; 

m_captureQueue.RemoveAll O ; 
lock.UnlockC) ; 

} 

position pos = m„channelMap.GetStartPositionC) ; 
if Cpos) 

int channel Number ; 
CChannel Stub* pChannel ; 
while (pos) 
{ 

m_channelMap.GetNextAssoc( pos, channel Number , pChannel ); 
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pchannel ->Fi reEvent Ccchannel Stub : : se__destroy) ; 

} 

} 

else // no channels to remove 
Fi reEvent (se ^deactivated) ; 

} 

void CChannelMngr : :OnChannelCreated(LPARAM iParaml, LPARAM lParam2) 
// Activate the channel 

CChannelStub* pchannel = (CChannel Stub*)l Paraml; 
pChannel ->Fi reEvent (SE_ACTIVATE) ; 

} 

void CChannelMngr : :onchannelDestroyed(LPARAM iParaml, LPARAM lParam2) 
{ 

// Look for the channel and remove it 
CChannelStub- pchannel = (CChannelStub*)! Paraml; 

CChannelStub* pchannel Found = NULL; 

if (m_channel Map. LookupCpChannel ->m_CMR. channel , pchannel Found)) 
{ 

ASSERTCpChannel Found == pChannel); 

// Remove the channel from the map and delete the channel object 
m_Channel Map. RemoveKey (pchannel Found->m_CMR. channel ) ; 
delete pchannel Found ; 

} 

else 
{ 

theApp. Log(ARCTOS_TRACEj., ARCTOS_CA__ERR_DEACTIVATE , 2, 
pChannel ->m_CMR. channel Name , "Channel not found"); 
ASSERT (FALSE) ; 

} 

} 

void CChannelMngr : :OnRemoveChannel (LPARAM iParaml, LPARAM lParam2) 

// Look for the channel and remove it 
CChannelStub* pchannel = (CChannelStub*)! Paraml; 

CChannelStub* pChannel Found = NULL; 

i f (m_ChannelMap . Lookup (pchannel ->m_CMR. channel , pchannel Found)) 
{ 

ASSERT(pchannel Found == pchannel); 

// Remove the channel from the map and delete the channel object 
m_ChannelMap . RemoveKey (pchannel Found ->m_CMR . channel ) ; 
delete pchannel Found ; 

} 

el se 
{ 

theApp . Log (ARCTOS_EVENT_WARNING , ARCTOS_CA_ERR_COMMAND , 2, 

pChannel ->m_CMR. channel Name, "removing", "Channel not found"); 
} 

// If all the channels were removed send a deactivated event 
if (m_ChannelMap.IsEmptyO) 

Fi reEvent (SE_DEACTIVATED) ; 

} 

/•" 

void CChannelMngr : :Onchannel Deactivated (LPARAM iParaml, LPARAM lParam2) 

{ 

// Loop over the list and check if we have anymore active channels 
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csingleLock lock(&m_channelListMutex, true); 

// cchannelstub* pDeacti vatechannel = (cchannelstub*)! Pa rami; 

POSITION pos = m_Channel Li st . GetHeadPosi ti on() ; 
while (pos) 

CChannel Stub-' pChannel = m„Channel List .GetNext(pos) ; 
if (pchannel ~>GetCurstate() != CChannel Stub : : ST_inactive) 
retu rn ; 

} 

Fi reEvent(SE_DEACTlVATED) ; 

V 

void cchannelMngr : :OnDeactivated(LPARAM iParaml, LPARAM lParam2) 
theApp . Log (arctos_event , arctos_ce_deactivate) ; 

theApp . m_pchannel MapFrm->m_Channel Li st . inval i dateRect (NULL , false) ; 
theApp. m_pStatusFrm->PostMessage(WM_DEACTlVATE__COMPLETE) ; 

} 

void cchannelMngr : :OnEncodeChannel (lparam 1 pa rami, lparam lParam2) 
{ 

CSingleLock 1 ock(&m_CaptureQueueMutex , TRUE); 
m_captureQueue . AddTai 1 ((CChannel Stub*) 1 Paraml) ; 
irucaptureQueueSemaphore.unlock(l) ; 

} 

void cchannelMngr: :OnAdminCommand (lparam iParaml, lparam lParam2) 

C HAN N E L_M A P_ROW * pCMR = (CHANNEL_MAP_ROW*) 1 Pa rami ; 

// Find a channel stub object for the channel number (if one exists) 
CChannel Stub* pChannel = Fi ndChannel (pCMR->channel ) ; 

// Handle the command 
switch (pCMR->changeFl ag) 
{ 

case cmd__none: 
break ; 

// „. 

// Create a new channel and activate it 
case cmd_add: 
{ 

// Does the channel already exist 

if (pChannel) 

{ 

theApp. Log (ARCTOS_EVENT_WARNING, 
arctos_CA_ERR_command, 3, pchannel ->m_CMR. channel Name, "adding", "Channel already 



exi sts") ; 



break; 

} 



// create the new channel and activate it 
pchannel = new CChannel stub(thi s , pCMR) ; 

if (IQE_SUCCESS == 

pChannel ->Open (pChannel ->m_CMR . channel Name , CIpcStateMachine : : F_CREATE)) 

theApp . Log (ARCTOS_TRACE_l , ARCTOS_CA_COMMAND , 2 , 

pChannel ->m_CMR . channel Name , "addi ng") ; 

m_channel Map . setAt (pchannel -xtlXMR . channel , 
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pchannel) ; 

} 

el se 
{ 

theApp . Log (ARCTOS_EVENT_WARNING , 
arctos_CA_err_command, 3, pchannel ~>tn_CMR . channel Name , "adding", "can't create IPC 
State machi ne . ") ; 

del ete pchannel ; 

} 

} 

break; 

// 

// Deactivate a channel and remove it 
case CMD_REMOVE : 

if (pchannel == NULL) 

{ 

theApp. Log (ARCTOS_EVENT„WARNING, ARCT0S_CA_ERR_COMMAND , 3, 
pchannel ->m_CMR. channel Name , 'removing", "Channel not found."); 

break ; 

} 

pchannel ->Fi reEvent (CChannel Stub : : SE_DESTROY) ; 
break : 



// 

// update channel information 
case cmd_update: 

if (pchannel) 



CHANNEL_MAP_ROW* pNewCMR = new CHANNEL_MAP_ROW; 

memcpy(pNewCMR, pCMR, si zeof (channel_map_row)) ; 
pchannel ->Fi reEvent (CChannel Stub: :SE_UPDATE, 

(lparam) pNewCMR) ; 

} 

else // Channel not found 

{ 

theApp. Log (ARCTOS_EVENT_WARNING, ARCTOS_CA_ERR_COMMAND , 3, 
pchannel ->m_ClviR . channel Name , "updating", "Channel not found."); 

break; 

} 

break; 

// 

// Get channel status 
case CMD_status: 
break; 

// „ 

// Activate a channel 
case CMD_ENABLE: 

// Does the channel already exist 

if (pchannel) 

{ 

theApp. Log (ARCTOS_TRACE_l, ARCTOS_CA_COMMAND , 2, 

pchannel ->m„CMR. channel Name, "adding"); 

pchannel ->m_CMR. active = true; 

pchannel ->Fi reEvent(cchannel Stub: : SE^.ctivate) ; 

} 

else 
{ 

Loginformation(APP_NAME, "Could not find channel to 
activate. Channel will be added."); 

theApp. Log (ARCTOS_EVENT_STRANGE, ARCTOS_CA_ERR_COMMAND , 3, 
pchannel ->m_CMR. channel Name, "enabling", "Channel not found."); 
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// Create the new channel and activate it 
pChannel = new CChannel Stub(thi s , pCMR) ; 
if (IQE_SUCCESS == 

pChannel ->Open(pchannel ->m_CMR . channel Name , ClpcStateMachi ne : : f_CREATE)) 

theApp. Log(ARCTOS_TRACE_l, ARCTOS_CA_COMMAND , 2, 
pChannel ->m„CMR. channel Name, "adding") ; 

m_Channel Map . SetAt CpChannel ->m_CMR . channel , 

pChannel) ; 

el se 
{ 

theApp. Log (ARCTOS_EVENT_WARNING, 
arctos_ca_err_command , 3, pchannel ->m_CMR . channel Name , "adding", "Error creating IPC 
state Machi ne") ; 

delete pchannel ; 

} 

break; 

} 

break; 

// „ ~ 

// Deactivate a channel and remove it 
case CMD_DISABLE: 

if CpChannel) 

{ 

theApp. Log (ARCT0S__TRACE„1, ARCTOS_CA_COMiV|AND , 2, 
pChannel ->m_CMR. channel Name, "disabling") ; 

pchannel ->Fi reEvent (CChannel stub : : se_deactivate) ; 

} 

el se 

{ 

theApp . Log (ARCT0S_TRACE_1 , ARCTOS_CA_ERR_COMMAND , 3 , 
pchannel ->m_CMR . channel Name , "disabling", "Channel not found"); 

} 

break; 

def aul t : 

theApp . Log (ARCTOS_EVENT_WARNING , ARCTOS_CA_ERR_COMMAND , 3 , 
pChannel ->m_CMR. channel Name, "unknown", "Invalid command"); 
break; 

} 

delete pCMR; 

} 

void cchannelMngr : :oncancelAdminCommand(LPARAM iParaml, lparam lparam2) 

CHANN EL_MAP_ROW* pCMR = (CHANNEL_MAP_ROW" ) 1 Paraml ; 

delete pCMR; 

} 

J it it it it it it it it it it it it it it i: it it it it >V it it it ;V ;V it it it it it it it it it it it it it it i; it if it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it 

* Internal Functions 



r it it it it it if it it it if i< it it it it it it i 



'e it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it it 



BOOL cchannelMngr: :LoadChannelMap() 

// Get the pathname where the database file is located 

cstring strDbFi 1 ePath = theApp . m_ArctosSetti ngs . szDatabaseFi 1 eName ; 

int cpos = strDbFilePath.ReverseFindC'W) ; 
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if (cpos == -1) 

theApp . Log (ARCTOS_EVENT_DEADLY , ARCTOS_CE_LOAD_CHANNEI — MAP , 2, 

theApp. m_y\rctosSetti ngs. szDatabaseFi 1 eName, "invalid path"); 
return FALSE; 

} 

strDbFilePath = strDbFilePath.Left(cPos) ; 

// Generate a temp filename for use in the CChannalMap class 
char szTempFi 1 e[_MAX_PATH] ; 

GetTempFil eName (strDbFilePath, "map", 0, szTempFi 1 e) ; 



{ 

szTempFi 1 e) ; 



CChannel Map map (theApp . m_ArctosSetti ngs . szDatabaseFi 1 eName , 

// Read the records 
CHANNEL_MAP_ROW cmr ; 

if (map.ResetLineReadO == error_success) 

theApp. m_pchannelMapFrm->m_Channel Li st . setRedraw(FALSE) ; 

while ( ! map .GetNextLi neC&cmr)) 
{ 

if (cmr. channel != 0) 
{ 

CChannel Stub- pchannel = new 

CChannelStub(thi s , &cmr) ; 

if (IQE_SUCCESS == 

pchannel ->open (pchannel ->m_CMR . channel Name , ClpcStateMachi ne : : f_create)) 



pchannel) ; 



} 

el se 
{ 



m„Channel Map. setAt (cmr . channel , 



del ete pchannel ; 
assert(false) ; 



} 
} 

} 

theApp . m_pchannel MapFrm->m_Channel Li st . Set Red raw (TRUE) ; 

} 

el se 

{ 

theApp. Log (ARCTOS_EVENT_DEADLY, arctos_ce_load_channel„map, 
2, theApp . m_ArctosSetti ngs . szDatabaseFi 1 eName , "Error reading database file."); 

return FALSE; 

} 

} 

if (" szTempFi le) 

Del eteFile (szTempFi le) ; 

return TRUE; 

} 

cchannelstub* CChannelMngr: : FindChannel (int Channel Number) 

{ 

CChannel stub* pchannel = null; 

if (m_ChannelMap. Lookup (Channel Number , pchannel)) 
return pchannel ; 
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el se 

return NULL; 



/**■ 



V? Vf "tftfie if Vf tff Vf Vr i'r Vr A Vr Vr iff it Vr Vf iV # i'j -^r i; rir Vr t"c V 



Capture Queue Thread 



DWORD CChannelMngr: :CaptureQueueThreadProc(LPVOiD IpData) 
{ 

CChannelMngr* pChannelMngr = (CChannelMngr-)! pData; 
return pchannelMngr->CaptureQueueProc() ; 

} 

DWORD CChannelMngr: :captureQueueProc() 
{ 

cscreenlmage Screen(640, 480); 

if (!screen.lnit()) 

{ 

ASSERT (FALSE) ; 

} 

while (!m_bQuit) 

m_CaptureQueueHeartbeat = GetTi ckCount() ; 

switch (WaitForSingleObject(m_CaptureQueueSemaphore, 100)) 
{ 

case WAIT_OB3ECT„0: 
{ 

csingleLock lock(&m_CaptureQueueMutex, true); 
CChannel Stub* pchannelstub = 



m_capturequeue. RemoveHeadO ; 



HWND_TOPMOST, 

theApp . m_statusFrameHei ght , 



lock.unlock() ; 

// Bring the window to the foreground 
setWindowPos (pchannel Stub->m_hwndChannelApp , 

0, 



theApp. m_ArctosSetti ngs . Col Count, theApp . m_ArctosSetti ngs , RowCount + 20, 

SWP_SHOWWINDOW) 

Sleep(300) ; 



i++, Sleep (100)); 

3) 
3) 

(%s) before redraw", 



// wait for the window to redraw 

for (int i = 0; i < 10 && pchannel stub->IsBusy() ; 



// Did it redraw or is it taking too long to redraw 
if (i < 10 | ! pchannel Stub->m_WaitForRedrawCounter > 

{ 

if (pchannel stub->m„Wai tForRedrawCounter > 

{ 

cstring strLog; 

strLog . Format (''Forced capture of %s 



pchannel Stub->m_CMR. channel Name, pchannel stub->m_pStatus->szCurrentUrl ) ; 
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i_oglnformation(APP_NAME, strLog) ; 

} 

pChannel Stub->m_Wai tForRedrawCounter = 0; 
try 

// Capture the screen image 
pChannel stub->m_channel Spec . Buffer = 

(UCHAR*)Screen .GetScreenImage(0, // src x 

theApp .m_StatusFrameHeight , // src y 
theApp. m^\rctosSetti ngs. Col Count, // src width 
theApp. m_Arctossettings.RowCount, // src height 
theApp. m_ArctosSetti ngs . Off setLeft, // dest x 
theApp. m_ArctosSettings. Off setTop) ; // dest y 

if 

(theApp . m_ArctosSetti ngs . Enabl eMux) 



pChannel Stub->m_Channel Spec. DataSize = Screen . GetSi ze() ; 
&pChannelStub->m_ChannelSpec ) ; 



// Send the image to the mux 
s32 ret = CmUpdateChannel ( 



CmUpdateChannel for %s" , 
pChannel Stub->m_CMR . channel Name) ; 



} 
} 

catch C ■ ■ ■ ) 
{ 

cstring strLog; 

strLog. Format ("Except! on calling 



LogInformation(APP_NAME, strLog) ; 
} 

if (++pchannel Stub->m_nNavCounter > 

theApp . rruArctosSetti ngs . NavsBef oreReset) 

pChannelstub->Fi reEvent(cchannel stub: :se_reset) ; 

} 

el se 
{ 

pChannel stub~>Fi reEvent(CChannel Stub: :SE_encoded) ; 

} 

// Send it to the back of the queue 
el se 

{ 

lock. LockO ; 

pChannel stub->m_Wai tForRedrawCounter++ ; 
m_CaptureQueue.AddTail (pChannel Stub) ; 
lock.UnlockO ; 
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Loglnformation(APP_NAME, "Wating too long 



} 



} 

} 

break ; 

case WAIT_TIMEOUT: 
break; 

def aul t : 

ASSERT(FALSE) ; 

} 

} 

return 0; 

't it k it it i: it it ■>',- k -V it * it *■ * -V * k -V V- V- V- -V * V- -fr it ft ft ft * ft ft ft ft it it it it it it it k k -k ft k k it it k it it it it it it if it it it it it it it it it it it it 

* HotFolderThread 

DWORD cchannelMngr: :HotFolderThreadProc(LPVOID lpData) 

CChannelMngr* pChannelMngr = (CChannelMngr-)lpData; 
return pChannelMngr->HotFolderProc() ; 

} 

DWORD CChannelMngr: ; HotFol derProcO 

CString strDbFi 1 ePath = theApp . m_Arctos5etti ngs , szDatabaseFi 1 eName ; 
int cPos = strDbFi 1 ePath . ReverseFi nd( ' \\ ' ) ; 
if (cPos == -1) 

LogInformation(APP_NAME, "Invalid db file path in hot folder proc"); 
return 0; 

} 

strobFilePath = strDbFi 1 ePath . Left(cPos) ; 

// Ask for notification if a file in the admin folder changed 
HANDLE hwait = FindFi rstChangeNotifi cation (strDbFi lePath, false, 
FILE„NOTIFY_CHANGE_LAST_WRITE) ; 

DWORD dwRet; 
while (!m_bQuit) 
{ 

dwRet = WaitForSingleObject(hWait, 100); 

switch (dwRet) 

{ 

case wait_ob J ECT^O : 

// Cancel the change notification so we don't get 

bogus changes later 

Fi ndcl osechangeNoti f i cati on (hWai t) ; 

char szTempFi 1 e [_MAX_PATH] ; 
GetTempFileName(strDbFilePath, "map", 0, 

szTempFile) ; 

{ 

CChannelMap 
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map(theApp.m_ArctosSettings. szDatabaseFi 1 eName , szTempFile) ; 



CHANN El MAP_ROW ; 



(LPARAM) pCMR , si zeof (CHANNEL_MAP_ROW)) 



// Read the records 

if (map.ResetLineReadO == error_success) 

{ 

C H A N N E L_M A P_ ROW * pCMR = new 

whi 1 e ( ! map . GetNextChange CpCMR) ) 



{ 



} 



Fi reEvent (SE_ADMIN„CMD , 
pCMR = new CHANNEL_.MAP._ROW; 



} 

el se 
{ 



reading database file") 



delete pCMR; 
l_oglnformation(APP_NAME, "Error 



} 



change 



DeleteFile (szTempFi le) ; 
ccarouselFile file; 

_CHANNEI INFO* pCi = new _CHANNEI — INFO ; 

csingleLock lock(&m_ChannelListMutex, true) ; 
// Open the database file and look for the next 
if 



(f i 1 e .OpenCtheApp. m„ArctosSetti ngs . szDatabaseFi 1 eName)) 



Si zeof C_CHANNEL_INFO)) ; 



// Loop over changes 

whi 1 e (f i 1 e . GetNextchangedRecord(pci ) ) 

Fi reEvent (se^\dmin„cmd , (lparam) pci , 



} 



pci = new _CHANNEL_INFO; 



del ete pci ; 

// Get the next change notification 
// file.FlushO ; 

file.CloseO ; 
// hwait = 

Fi ndFi rstchangeNoti f i cati on Cst rDbFi 1 ePath , false , file_notify_change_last_write) ; 

*/ } 

} 

hwait = Fi ndFi rstchangeNoti fi cati on (strDbFilePath, FALSE, 
FILE_NOTIFY_CHANGE_LAST_WRITE) ; 

break; 
case WAIT_TIMEOUT: 
break; 

default: 

m_bQuit = TRUE ; 
break; 

} 

} 



page 12 



Channel Mngr . cpp 
Fi ndcl osechangeNoti f i cati on (hwai t) ; 



return 0; 

} 

watchdogThread 

DWORD cchannelMngr : :watchdogThreadProc(LPVOlD IpData) 

CchannelMngr* pChannelMngr = (cchannelMngr*)! pData; 
return pChannelMngr->WatchdogProc() ; 

} 

DWORD cchannelMngr: :Watchdogproc() 

while (!m_bQuit) 

{ 

Sleep(250) ; 

DWORD curtime = GetTi ckCountC) ; 

if (curtime - m__captureQueueHeartbeat > queue_thread_timeout && 
theApp . m_ArctosSetti ngs . Enabl eMux) 

Loglnformation(APP„NAME , "Capture queue hung. System will 

shut down") ; 

Fi reEvent (SE_D EACTIVATE) ; 

} 

} 

return 0; 
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TcpEnc.cpp 

NAME: TcpEnc.cpp 



PURPOSE : To recieve a video PES stream from a TCP port as 
input to the multiplexer. 

description: 



HISTORY: vH^m Tim Lee from SimEnc.cpp by Allan Moluf. 

copyright by ictv, inc. All rights reserved. 
v 

#include <math.h> 
#include <stdio.h> 

#include "ictvMpeg.h" // iCTV-specific MPEG conventions. 
#inc!ude "TcpEnc. h" 
#include "TsPid.h" 
#include "TrialMgr.h" 

// class variable declarations 

// Register the sub-class TcpEnc for setup-file parsing when 

// static objects are initialized at program start up. 

Encoder: : EncParseObject TcpEnc: : s_parseObject( "TCP", "TcpEnc", setup ); 

#define bytes_per_ts„packet 188 
// The size of a ts packet. 

// Number of frames delay between wait queue exit and mux exit. 
#define NORMAL_OUTPUT_DTS_STILL (2.5) 
#define NORMAL_OUTPUT_DTS (3.0) 

// MPEG Picture Header Structure 
enum 
{ 

PICTURE_CODING_TYPE_INDEX 

PI CTU R E_CODI NG_TYP E_S H I FT_COU NT 
PICTURE_CODING_TYPE_MASK 
PICTURE_CODING_TYPE_I 
PICTURE_CODING„TYPE_P 
PICTURE_CODING_TYPE_B 

};■ 

//mpeg Start Code values: all prefixed by three bytes 0, 0, 1. 
enum 

{• • • • . ' • ' ■■■ 

PICTURE_START_CODE = 0, 

FIRST_SLICE_START_CODE =1, 
LAST_SLICE_START_CODE =0xAF, 
RESERVED. START_CODE_A = OxBO, 

RhSLRV LD...START... COD E_B - OxBl, 

USER„DATA_START_CODE = 0xB2, 

SEQUENCE_HEADER_START_CODE — 0xB3, 
SEQUENCE_ERROR_CODE = 0xB4, 

EXTENSION_START_CODE =0xB5, 
RESERVED_START_CODE_C = 0xB6, 

SEQUENCE_END_CODE = 0xB7, 

GROUP_START_CODE = 0xB8 , 

FIRST_SYSTEM„START_CODE = 0xB9, 
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= 5, // offset from first 
// start code byte. 

= 3, 

= 7, 
= 1, 

= 2, 
= 3 



}; 



LAST SYSTEM_START_CODE 



TcpEnc. cpp 
= Oxff 



// Transport packet Header structure 
enum 



}; 



SYNC_BYTE_INDEX 

SYNC_BYTE_VALUE 

PAY LO A D_S TA RT_I N D EX 

PAYLOAD_START_BIT 

P I D_H I_ BYT E_I N D EX 

PID_HI_BYTE_MASK 

PID_LO_BYTE_INDEX 

A DA PT_CTR L_I N D EX 

HAS_ADAPT_BIT 

HAS_PAYLOAD_BIT 

CONT_CTR_INDEX 

CONT_CTR_MAS K 

ADAPT_LEN_INDEX 

ADAPT_FLAGS_INDEX 

ADAPT_DISC_FLAG_BIT 

ADAPT_PCR_FLAG_BIT 

ADAPT_PCR_INDEX 



= 0, 



0x47, 
1, 



= 1, 
= I 

= 2, 



Oxlf , 
= 3, 



= 3, 

= 4, 
= 5, 



= 6 



0x40, 



0x20, 
0x10, 

OxOf , 



0x80, 
0x10, 



// pes Packet Header structure 

enum 

{ 

PAC K ET_S TA RT_I N D EX = 0, // the first 
5TREAM_ID_INDEX = 3, 

P ES_PACK ET_L E NGTH_H I BYTE = 4, 
PES_PACKET_LENGTH_LOBYTE = 5, 



3 bytes should be 00, 00 ,01 



}; 



DATA_J\LIGN_INDEX = 6, 

DATA_ALIGN_BIT 
PTS_FLAG_INDEX = 7, 

PTS_FLAG_BIT 

DTS_FLAG_INDEX = 7, 

DTS_ F L AG_ BIT 

PES_HDR_LEN_INDEX = 8, 

PTS_INDEX 

DTS_INDEX 



0x04, 

0x80, 

0x40, 

= 9, 
= 14 



// This is the d 
// 480 scanlines 
Ulnt8 

DummyCodedPFrame[] = 

{ ■ 



lata for a dummy coded P-frame. 
/ 16 lines per macro block = 30 slices, 



o, 


o, 


1, 


0x00, 


0x0c, 


0x90, 


0x75, 


0x33, 


0x80, 


// 


PIC HDR 


o, 


o, 


1, 


0xb5, 


0x82, 


0x2f , 


0xf3, 


0xc9, 


0x80, 


// 


PIC COD EXT 


o, 


o, 


1, 


0x01, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


01 


o, 


o, 


1, 


0x02, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


02 


o, 


o, 


1, 


0x03, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


03 


o, 


o, 


1, 


0x04, 


0x2a, 
0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


04 


0, 


0, 


1, 


0x05, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


05 


0, 


o, 


1, 


0x06, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


06 


o, 


o, 


1, 


0x07, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


07 


o, 


0, 


1, 


0x08 , 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


08 


o, 


o, 


1, 


0x09, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


09 


o, 


o, 


1, 


0x0a, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


10 


o, 


o, 


1, 


0x0b, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


11 


o, 


o, 


1, 


0x0c, 


0x2a, 
0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


12 


o, 


o, 


1, 


OxOd, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


13 
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o, 


o , 


1, 


OxOe , 


0x2a , 


0x70, 


0x10, 


0x33 , 


0x80 , 


// 


SLICE 


14 


o, 


o , 


1, 


OxOf , 


0x2a , 


0x70, 


0x10, 


0x33 , 


0x80 , 


// 


SLICE 


15 


o, 


0 , 


1, 


0x10, 


0x2a , 


0x70, 


0x10, 


0x33 , 


0x80 , 


// 


SLICE 


16 


o, 


o, 


1, 


Oxll, 


0x2a, 


0x70, 


0x10, 


0x33 , 


0x80, 


// 


SLICE 


17 


o, 


0, 


1, 


0x12 , 


0x2a, 


0x70, 


0x10, 


0x33 , 


0x80, 


// 


SLICE 


18 


o, 


o, 


1, 


0x13, 


0x2a, 


0x70, 


0x10, 


0x33 , 


0x80, 


// 


SLICE 


19 


o, 


o, 


1, 


0x14, 


0x2a, 


0x70, 


0x10, 


0x33 , 


0x80, 


/ / 


SLICE 


20 


n 


u , 


-•-1 


flvl c; 
UX±D , 


ux^_a , 


ux/ u , 


UXXU , 


Uajj , 


UXoU , 


11 




/I 


o, 


o, 


1, 


0x16, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 




0, 


o, 


1, 


0x17, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


23 


o, 


o, 


1, 


0x18, 


0x2 a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


24 


0, 


o, 


1, 


0x19, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


25 


o, 


o, 


1, 


Ox la, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


26 


0, 


0, 


1, 


Oxlb, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


27 


o, 


o, 


1, 


Oxlc, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


28 


o, 


o, 


1, 


Oxld, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80, 


// 


SLICE 


29 


o, 


o, 


1, 


Oxle, 


0x2a, 


0x70, 


0x10, 


0x33, 


0x80 


// 


SLICE 


30 



TcpLogRecord TheLogRecord; 

// The current log record. 

#define log_record_count 1000 

// How many log records should be collected, one 
// record per output frame. 



extern "c" 
{ 



u32 GetQuantiserScaleCodeC u8* ); 

void incrementTemporal Sequence C u8* ); 

void PutQuanti serScal eCodeC u8*, u32 ); 

void SetPictureCodingTypeC u8*, u32 ); 

u8* ToSliceC u8*, u8* ) ; 

u8* ToSpecificStartCodeC u8*, u8*, u32 ); 

} 

/* 

name: GetQuantiserScaleCode 



PURPOSE: To get the value from the quantiser_scale_code 
field of a picture slice. 

DESCRIPTION: Given the address of first byte of a picture 
slice this routine fetches the five bit value held in the 
quanti ser_scal e_code field. 

example: 

qsc = GetQuantiserScaleCodeC Atslice ); 

NOTE: 
ASSUMES: 



HISTORY: 




_ */ 

u32 

GetQuantiserScaleCodeC u8* Atslice ) 
{ 

u32 n; 
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// The quantiser_scale_code field is 5 bits long and it 
// starts at byte offset 4 from the beginning or the 
// slice, being held in the high five bits of the byte. 

// Fetch the value and shift it into the low bits of 
// a 32-bit value. 

n = (u32) C C AtSlice[4] » 3 ) & OxlF ); 

// Return the result. 
returnC n ) ; 

} 

/* 

name: IncrementTemporal Sequence 



purpose: To increment the value held in the temporal 
reference field of a Picture Header 

DESCRIPTION: Given the address of a Picture Header this 
routine increments the value in the temporal reference 
field. 

EXAMPLE : 

IncrementTemporal sequenceC AtPicture ); 

NOTE: 

ASSUMES : 

HISTORY: iflBH 

_ */ 

void 

IncrementTemporal SequenceC u8* AtPicture ) 
u32 TempRef ; 



// The temporal reference field is 10 bits long and it 
// starts at byte offset 4 from the beginning of the 
// Picture Header. 

// Get the high 8 bits. 
TempRef = AtPicture [4] « 2; 

// Merge the low 2 bits. 

TempRef |= ( AtPicture[5] » 6 ) & 3; 

// increment the temporal reference number. 
TempRef ++; 

// Put back the high 8 bits. 
AtPicture [4] = (u8) ( TempRef » 2 ); 

// Put back the low 2 bits. 
AtPicture[5] = ( AtPicture[5] & 0x3f ) | 
( ( TempRef & 3 ) « 6 ) ; 

} 

/* 

| name: MakeDummycodedPFrame 
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PURPOSE: To make a dummy coded P picture that repeats a 
given I picture. 

DESCRIPTION: Returns a P picture at the destination buffer 
and the return value is the size of the P picture in 
bytes. 

Returns zero if no valid P picture could be constructed. 
EXAMPLE: 

ByteCount = MakeDummyCodedPFrameC 
AtlPicture, 
AtlPictureEnd, 
AtPPicture ); 

NOTE: 

ASSUMES: 

history: flMBMi 

// Returns the number of bytes in the 
u32 // resulting P Picture. 

MakeDummyCodedPFrameC 

u8* AtlPicture, // The first byte of the Picture Header 
// of the I Picture used as the source. 
// 

u8* AtlPictureEnd, 

// The first byte after the last byte in 
// the I Picture used as the source. 

// 

u8* AtPPicture )// The destination buffer where the 
// P Picture will be stored. 



7 



{ 



u8* AtPPictureEnd; 

u8* AtSlicel; 

u8* Atslicep; 

u32 Q, ByteCount; 

u32 PictureHeaderByteCount; 

u32 SliceNumber; 

// If the source picture is missing, 
"if C ! AtlPicture ) 
{ 

// Return zero to signal an error. 
return( 0 ) ; 

} 

// Find the first slice in the source picture. 
AtSlicel = TosliceC AtlPicture, AtlPictureEnd ) ; 

//if no slice was found in the picture. 
ifC ! AtSlicel ) 

" 

// Return zero to signal an error. 
returnC 0 ) ; 

} 

// Calculate the number of bytes in the picture 
// header plus picture code extension. 
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Pi ctureHeaderByteCount = Atslicel - AtlPicture; 

// Copy the picture header to the destination buffer, 
memcpyC AtPPicture, 
AtlPicture, 

pi ctureHeaderByteCount ); 

// Account for the new header bytes added to the 
// p Picture. 

AtPPictureEnd = AtPPicture + Pi ctureHeaderByteCount; 

// increment the value of the temporal sequence 
// number in the new picture header. 
incrementTemporalSequenceC AtPPicture ); 

// Set the picture coding type to P type. 

setPicturecodingTypeC AtPPicture, (u32) picture_coding_type_p ); 

// For every slice in the source picture. 

whileC Atslicel ) 

{ 

// Get the slice number from the current slice. 
SliceNumber = Cu32) Atslicel [3]; 

// Find the corresponding slice in the template dummy 
// coded P picture. 
AtSliceP = 

Tospeci f i cstartcode ( 

DummyCodedPFrame, 

// Address of the byte where the search 

// begins. 

// 

DummyCodedPFrame + sizeof( DummyCodedPFrame ), 
// Address of the first byte after 
// the last valid byte in the range. 

SliceNumber ); 

// The value of the fourth byte of 
// the target Start Code. 

// If the P slice was found. 

if C AtSliceP ) 

{ 

// Copy the slice template data to the p picture 
// buffer: there are nine bytes in each dummy 
// slice. 

memcpyC AtPPictureEnd, 
AtSliceP, 
(u32) 9 ); 

// Account for the new header bytes added to the 
// P Picture. 
AtPPictureEnd i= 9; 

//Get the quantiser scale_code from the 
//I picture slice. 

Q = GetQuantiserScaleCodeC Atslicel ); 

// Put the quanti ser_scale_code into the p 
// slice. 

PutQuantiserScaleCode( AtSliceP, Q ); 
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// Advance to the next I slice. 

Atslicel = Toslice( Atslicel + 4, AtlPi ctureEnd ); 

} 

// calculate the number of bytes in the P picture. 
ByteCount = AtPPi ctureEnd - AtPPicture; 

// Return the picture size. 
returnC ByteCount ); 

} 

/* 

NAME: PutQuantiserScaleCode 



purpose : to put a value into the quantiser_scale_code 
field of a picture slice. 

DESCRIPTION: Given the address of first byte of a picture 
slice this routine stores a five bit value into the 
quanti5er_scale_code field. 

EXAMPLE : 

PutQuantiserScaleCodeC AtSlice, NewValue ); 

NOTE : 
ASSUMES : 

HISTORY: W' 
________ */ 

void 

PutQuantiserScaleCodeC u8* AtSlice, u32 Newvalue ) 
{ 

u8 A; 

// The quantiser_scale_code field is 5 bits long and it 
// starts at byte offset 4 from the beginning or the 
// slice, being held in the high five bits of the byte. 

// Fetch the byte holding the field. 
A = AtSlice [4] ; 

// Punch a hole for the new value: the low 3 bits are 
// preserved. 
A &- 7 ; 

// Shift and merge the new value. 
A j= (u8) ( NewValue « 3); 

// Put the whole byte back. 
AtSlice [4] = A; 

/---------------------------------------^ 

NAME: SetPi cturcCodi ngType 



purpose: To set value of the Picture Coding Type field in 
a Picture Header. 

description: Given the address of a Picture Header this 
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routine stores a value into the Picture Coding Type field. 
EXAMPLE: 

setPicturecodingTypeC AtPicture, picture_coding_type_p ); 

NOTE : 
ASSUMES : 



HISTORY: 




void 

SetPicturecodingTypeC 

u8* AtPicture, // Address of a Picture Header. 

// 

u32 PictureCodingType ) // Must be one of these values: 

// PICTURE_CODING_TYPE_I 

// PICTURE_CODING_TYPE 
// PICTURE_CODING_TYPE 

{ 

u8 A; 

// Fetch the byte containing the field. 

A = AtPicture [ picture_coding_type_index ]; 

// Punch a hole for the new value. 

A = A & 

C ~( (u8) picture_coding_type_mask « 
picture_coding_type_shift_count ) ) ; 

// Merge the new value into the byte. 
A |= (u8) ( PictureCodingType « 

picture_coding_type_shift_count ) ; 

// Store the byte back to the picture header. 
AtPicture[ picture_coding„type_index ] = a; 



NAME: TcpEnc: :TcpEnc 



PURPOSE: To make a TcpEnc object. 
description: 



EXAMPLE : 



NOTE: 



ASSUMES: 

HISTORY: .ttMBfe 

IBM Added PES arrival time i nits. 

„ ,y 

TcpEnc: :TcpEnc() : Encoder ("TcpEnc") , 
d_i svi deo Cf al se) , 
d_InputBufSize( 1024*128 ) , 
d_lnputFramecountCO) , 
d_OutputFrameCount(0) , 
d_totalPesData(0.0) , 
d_dbgLev(0), 
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d_BytesReceived(0) , 
disconnected ( 0 ), 
d„LogBuffer( 0 ) , 
d_LogBufferEnd( 0 ) , 
d_lsFi rst Frame ( 1 ) 

// use ctor-initializers where possible 

// then allocate memory and initialize other members 

// Allocate the input buffer to hold data read from the 
// TCP socket. 

d_InputBuf = (Ulnt8*) mallocC d_lnputBufSize ); 

// Set the timestamp base offset to zero. 
d_TimeStamp. setBaseTime( 0.0 ); 



name: TcpEnc: :~TcpEnc 
purpose : To delete a TcpEnc object. 

DESCRIPTION : 
EXAMPLE : 
NOTE: 
ASSUMES: 
HISTORY: 

TcpEnc: : -TcpEnc 0 

// Delete any owned objects and allocated space. 

// Close any open socket connection and discard the 
// socket. 
CloseConnectionO ; 

// If an input buffer is allocated. 
if( d_inputBuf ) 

{ 

free( d„lnputBuf ) ; 

} 

/*_ ____ 

NAME: TcpEnc: :AdjustFrameTimeStamps 

PURPOSE: To adjust the any PTS/DTS values in the current 

PES ■ frame.' ^ ■ 

DESCRIPTION: 
EXAMPLE : 
NOTE : 

ASSUMES: STC time refers to the byte currently leaving 
the mux. 
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I - 

I HISTORY: ■■■■■ Copied from SimEnc: :threadstep. 
*/ 

void 

TcpEnc: :AdjustFrameTimestamps() 
double delta; 
// Insert current PTS/DTS. 

// TBD exactly how we want to express this -- the basic 
// idea is that for simulation (or most real encoding) we 
// expect to get a steady increase in dts values 
// (when PT5 != DTS, the PTS will follow ths DTS by some 
// number of frame periods). We have modelled this in 
// outputDtsQ, which gets initialized by the offset we 
// want at the first pes buffer with a PTS, 
// 

// Now if PTS==DTS, we expect them to be the next value 

// (using dtsIncO), 

// 

//If PTS and DTS are both specified, then DTS follows 
// this simple pattern and we make the adjusted PTS keep 
// the same offset. 
if( pes()->ptsFlag() ) 
{ 

//if there is a dts field in the pes header. 
if( pes()->dtsFlag() ) 

// Calculate how much delay is currently 
// specified between the PTS and the DTS. 
delta = pes()->pts() - pes()->dts() ; 

// Set the DTS to the value set when the PES 
// buffer is output. 
pes()->changeDts( outputDtsO ); 

// Maintain the original delay between the dts 
// and the the PTS. 

pes()->changePts( outputDtsO + delta ); 

else // There is no DTS field. 
{ 

// Set the PTS to the value set when the PES 
// buffer is output. 
pes()->changePts( outputDtsO ); 

} } 

■■■■// if debug info should be output. 
if( d_dbgi_ev & 2 ) 

.....{■ ■ ' ■ ■ . . ' ' . . • • 

if( pes()->ptsi lag() ) 

\ ■■ . ■■ . cout « TimeStamp: :ts() « " " 

<< threadNameO << " threadstep newPts=" 
« util : :formatFixed(pes()->pts() , 5) ; 

if( pes()->ptsFlagO ) 

cout « " newDts=" « 
Util : :formatFixed(pes()->dts() > 5) ; 

. } 
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cout « " outputDts=" « util : :formatFixed(outputDts() , 5) « 

end! ; 

} 

} 

} 

/* 

name : TcpEnc : : Cl oseConnecti on 

PURPOSE: To close any open TCP connection. 

description : if the socket is already closed then nothing 
is done. 

if connected then: 

1. if the socket exists to be closed it is closed. 

2. The connection state is set to not connected. 
EXAMPLE: 
NOTE: 

assumes: 

HISTORY : ^■■P Factored out of TcpEnc: :threadstep() . 
__ */ 

void 

TcpEnc: : Cl oseConnecti on 0 

{ 

TcpLogRecord* AtLogRecord; 

// if the TCP socket is connected. 

if( disconnected ) 

{ 

// if a valid data socket is open. 

if( d_Socket ) 

{ 

// close the socket. 
Socket_Close( d_Socket ); 

// Mark the socket as deleted. 
d_Socket =0; 

// if a valid listening socket is open. 
if( d_Li stenSocket ) 

{ . ' . • • 

// close the socket. 
Socket_Close( d„Li stenSocket ); 

// Mark the socket as deleted. 
d_i i stenSocket = 0; 

} ■ ' 

// Set the socket state to disconnected, 
disconnected = 0; 

// So there are no bytes that can be read. 
d_BytesAvailable =0; 
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// if dumping pes packet data to a log file. 

ifC d_dbgLev = 10 ) 

{ 

// close the log file. 
fcloseC d_LogFile ); 

// And exit. 
exit(0); 

} 

// if the debug log should be written. 
if( d_dbg_ev == 9 ) 

// Then open a special log file. 
d_LogFile = fopen( "TcpLog.txt", "w" ); 

// Refer to the first log record. 
AtLogRecord = (TcpLogRecord*) d_LogBuffer; 

// For each log record. 

whileC C (u8*) AtLogRecord ) < d_LogBufferEnd ) 

// output the stc followed by outputDts 
// and the frame number. 
fprintfC d_LogFile, 

"%f\t%f\t%f\t%f\t%d\n" , 
AtLogRecord->Stc , 
Atl_ogRecord->Requestedwai t , 
AtLogRecord->Actual Wai t , 
AtLogRecord->OutputDts , 
AtLogRecord->InputFrameNumber ); 

// Advance to the next frame. 
AtLogRecord++; 

} 

// Close the log file. 
fcloseC d_LogFile ); 

// Clear the file handle. 
d_LogFile = 0; 

// Free the log buffer. 
free( d_LogBuffer ); 

// Mark the buffer as missing. 
d_LogBuffer =0; 
d_LogBuf FerEnd =0; 
d_LogRecordCount =0; 

// Quit the application. 
exitC 0 ) ; 

. . • . • . .}•• 

. ■ }.:■■: ' • 
:};.■;;,■;■:■: . 

■/* __________ _____ 

name: TcpEnc: : Normal izeoutputDts 



PURPOSE: To keep the outputDts value within bounds. 

description: OutputDts is the earliest time a frame can 
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leave a frame input queue for input into the mux. 

STC is the point in time where a byte is leaving the mux. 

outputDTS is initialized to the current STC adjusted by 
the amount of time it takes a frame to flow through the 
mux. 

For frames after the first frame outputDts is advanced by 
one frame time each time a new frame is added to the frame 
input queue using enqueuePesBuf () . 

Sometimes the outputDts value departs widely from its normal 
value of Stc + DtsOffset. 

if the deviation is more than an amount that might cause 
confusion downstream then some sort of correction must be 
made. 

OUTPUTDTS NORMALIZATION RULE: The current convention is to 
reset the outputDts to Stc + DtsOffset if the tolerance 
level is exceeded. 

EXAMPLE: 

NOTE: 

ASSUMES : 

HISTORY: flHH. copi ed f rom simEnc: :threadstep. 

Revi sed to protect against out of bounds 
conditions that corrupt data in the 
^^^—^ pipeline. 

^^HHt Factored out ResetOutputDts . 

■HHP Cleaned up and redocumented , renamed from 
ComputeOutputDts . 



Normal i zeOutputDts O 

double Stc, DtsOffset, OutputDts; 
double OutputDtsTol , OutputDtsDev; 

// Get local copies of the values we need, 
stc = util : :stcTime() ; 

DtsOffset = dtsOffsetO; 
OutputDts = outputDts O; 

// use 1/2 DtsOffset as the tolerance. 
OutputDtsTol = DtsOffset * .5; 

// Compute the absolute deviation from the norm. 
OutputDtsDev = fabsC Stc + DtsOffset - OutputDts ); 

//if the deviation exceeds the tolerance. 
ifC OutputDtsDev > OutputDtsTol ) 

{ ■■■■ ■ ■ ■ 

// Reset the OutputDTS to be the current STC 
// adjusted by the amount of time it normally takes 
// a frame to flow through the mux. 
ResetOutputDts O ; 
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/* 

name: TcpEnc: : setup 



PURPOSE: To parse the configuration file to set up a TCP 
type input. 

description : setupO handles these setup parameters: 

Type=xxx[,id] Required Video/AC3/Audio 
C Audio means MPEG-1 audio) 

use Type=video,0x80 for GI video 

Prog=nnn Required Program number in mux output 

Port=xxx Required input TCP port number 

Rate=nnn.n Required ES rate in bits/sec 

PID=nnn Required ES PID in mux output 

Hz=nnn.n Optional 24/25/29.97/30/50/60 (for video only) 

PMT=nnn Optional PMT PID in mux output 

TimeOut=n.n Optional The maximum number of seconds the 

TCP connection may remain open 
without receiving data before 
the connection is closed and 
reset. A multiplier of 5 is 
applied to the Timeout parameter 
for the period between the initial 
connection and the arrival of 
the first byte. The default value 
for Timeout is 2 seconds. 



Dbg=nn Optional Debug options 

if all the required parameters are found, all values are 
valid, and the port can be opened, we create a TcpEnc object 
and return a pointer to it. Otherwise, we output an error 
message and return NULL. 

The parser may also throw an exception for some bad input 
text. 



example: 



NOTE: 



ASSUMES : 
HISTORY: 



i Added Timeout parameter. 

_______________ */ 



Encoder* 
TcpEnc: :setup( NvParse &parse ) 

{ " • • • 

boo I have'i ype; 

boo! haveprog; 

bool havePort; 

boo! haveRate; 

bool havePID; 

bool haveHz; 

bool havePMT; 

bool haveTimeOut; 

bool haveDbg; 
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Ulntl6 

TsPkt: :PidType 

TsPkt: :PidType 

doubl e 

doubl e 

double 

doubl e 

int 

char* 

Ulnt32 

Int32 

const string* 
const string* 
TcpEnc* 
Ulnt32 



esPid ; 
pmtPid; 
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streamType; 
progNum; 



bitRate; 
Timeout; 
dtslnc; 

defaultDtslnc; 

nval s ; 

endPosn; 

tval ; 
PortNumber ; 
nam; 
val ; 

enc; 
dbgLev; 



// Start with no input parameters parsed. 



haveType 
haveprog 
havePort 
haveRate 
havePID 
haveHz 
havePMT 
haveTi meOut 
haveDbg 



false; 
fal se ; 
false; 
false; 
false; 
fal se ; 
false; 
false; 
fal se ; 



// until all parameters have been parsed. 
whileC 1 ) 

{ 

parse. advanceO ; 

nVals = parse, val CountO ; 

if( nvals < 0 ) 
{ 

break; 

} 

nam = parse. nameO ; 

// if the parameter name is recognized. 
if( *nam == "Type" 

*nam == "Prog" 

-'nam == "Port" 

*nam == "pid" 

*nam == "PMT" 

*nam == "Hz" 

*nam == "Rate" 

*nam == "Timeout" 
*nam == "Dbg" ) 



} 



// Proceed. 



■else'// The parameter name is not recognized. 
// Report the error. 

cout « "Parse error at line " « parse. lineNumO « 
": Unexpected parameter " « *nam « endl ; 

cerr « "Parse error at line " « parse. lineNumC) « 
": Unexpected parameter " « *nam « endl; 
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throw ExcpobjC'TcpEnc: :parse internal error for " + *nam) ; 
return NULL; 



if any parameters have other than 1 value, handle first 
*nam == "Type" ) 

// TBD complain if repeated 
if C nvals < 1 I I nVals > 2 ) 
{ 

// Report the error. 

cout « "Parse error at line " « parse. lineNumO « 
": " « *nam « "= expects 1 or 2 values, not " « 
nVals « end! ; 

cerr « "Parse error at line " « parse. lineNumO « 
": " « *nam « "= expects 1 or 2 values, not " « 
nval s « endl ; 

return NULL; 

} 

val = parse. val (0) ; 

// if the stream type is recognized. 
if( *val == "Video" | | 

*val == "Audio" | | 

*val == "AC3" ) 

{ 

; // Proceed. 

else // The stream type is not recognized. 
{ 

// Report the error. 

cout « "Parse error at line " « 

parse. lineNumO « ": bad value for " « 

*nam « "=" « *val « endl ; 

cerr « "Parse error at line " « 

parse. lineNumO « bad value for " « 

*nam « "=" « *val « endl ; 

return NULL; 

} 

ifC *val == "video" ) 

{ .. . . • • • • • 

streamType = TsPkt: :MPEG2_VIDEO_STREAM; 

// 29,97 HZ 

defaultDtslnc = 3003.0; 

:.} • ■ . • • 

if C -val == "Audio" ) 

{ ■ ' - ■ 

streamType ~ TsPkt: :mpeg2_audio_stream; 

// 41.667 Hz = 48 khz / 1152 samples/frame 
defaultDtslnc = 2160.0; 

} 
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if C *val == "AC3 " ) 

streamType = TsPkt: :AC3^\UDI0_STREAM; 

// 31.25 Hz = 48 khz / 1536 samples/frame 
defaultDtsInc = 2880.0; 

} 

//If there is a second value associated with 
// the 'Type' parameter. 
ifC rivals == 2 ) 

val = parse. val CI) ; 

tval = strtouK val->c_str() , &endPosn, 0 ); 

ifC *endPosn != '\0' \\ tval > Oxff ) 

cout « "Parse error at line " « 

parse. lineNumC) « ": bad number value for 

-nam « "=" « *val « end! ; 

cerr « "Parse error at line " « 

parse. lineNumC) « ": bad number value for 

*nam « "=" « *val « endl ; 

return NULL; 

} 

streamType = tval ; 

} 

haveType = true; 
continue; 

} 

// All the remaining parameters expect 1 value. 
if( nVals != 1 ) 

cout « "Parse error at line " « parse. lineNumC) « 
": " « *nam « "= expects 1 value, not " « 
nval s « endl ; 

cerr « "Parse error at line " « parse. lineNumC) « 
": " « *nam « "= expects 1 value, not " « 
nval s « endl ; 

return NULL; 

} . 

val = parse. val CO) ; 

ifC *nam == "Prog" ) 

{ ' ' ' ' ' ■ ' ' ' 

// TBD complain if repeated 

progNum = strtoul Cval ->c_strO , &endPosn, 0); 

if C *endPosn != '\0' ) 

cout « "Parse error at line " « parse. lineNumC) « 
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": bad number value for " « *nam « "=" « 
*val « end! ; 

cerr « "Parse error at line " « parse. lineNumO « 
": bad number value for " « *nam « "=" « 
*val « end! ; 

return NULL; 

} 

haveProg = true; 
continue; 

'nam == "Port" ) 

// tbd complain if repeated 

// Convert the port number string to an integer. 
PortNumber = strtoulC val ->c_str() , &endPosn, 0 ); 

havePort = true; 

continue; 

t n am == "PID" ) 

// tbd complain if repeated 

esPid = strtoulC val->c„strO , &endPosn, 0 ); 

ifC &endPosn != '\0' ) 

cout « "Parse error at line " « parse. lineNumO « 
": bad number value for " « *nam « "=" « 
*val « end! ; 

cerr « "Parse error at line " « parse. lineNumO « 
": bad number value for " « *nam « "=" « 
*val « end! ; 

return null; 

} 

// check to see if the PID is already reserved. 
if( TsPid: :isPidReserved(esPid) ) 

cout « "Parse error at line " « parse . 1 i neNumO « 
": PID is already reserved for " « *nam « "=" « 
*val « endl ; 

cerr « "Parse error at line " « parse. lineNumO « 
": PID is already reserved for " « *nam ■«■"=" ■« 
■'val « end I ; 

return NULL; 



// Reserve the PID. 
TsPid: : reservePid(esPid) ; 

havePID = true; 
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continue; 



■if C *nam == "PMT" ) 

// TBD complain if repeated 

pmtPid = strtoul (val->c_str() , &endPosn, 0); 

if( *endPosn != '\0' ) 

cout « "Parse error at line " « parse. lineNumO « 
": bad number value for " « *nam « "=" « 
*val « endl ; 

cerr « "Parse error at line " « parse. lineNumC) « 
": bad numbei ' " " ' " " 

*val « endl ; 

return null; 

} 

havePMT = true; 
conti nue; 

} 



if C *nam == "Hz" ) 
{ 

// TBD complain if repeated 

// *val * ptslnc should equal 90000 

dtslnc = 0. ; 

if C *val == "23.976" ) dtslnc = 3753.75; 

if C *val == "24" ) dtslnc = 3750.0; 

if C *val == "25" ) dtslnc = 3600; 

if C *val == "29.97" ) dtslnc = 3003.0; 

if C *val == "30" ) dtslnc = 3000.0; 

if C *val == "50" ) dtslnc = 1800.0; 

if C *val == "59.94" ) dtslnc = 1501.5; 

if C *val == "60" ) dtslnc = 1500.0; 

// if the frame rate is not valid. 
■ if C dtslnc == 0. ) 
{ 



//Report the error, 
cout « "Parse error at line " « parse. lineNumC) « 
": bad number value for " « *nam « "=" « 
*val « endl ; 

cerr « "Parse error at line " « parse. 1 ineNumO << 
" : bad number value for "« -nam « "-" « 
*val « end I ; 

return NULL; 



} 

haveHz - true; 
continue; 
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endl ; 
end! ; 
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if( *nam == "Rate" ) 

// tbd complain if repeated 

bitRate = strtod(val ->c_str C) , &endPosn) ; 

if C *endPosn != '\0' ) 

cout « "Parse error at line " « parse. lineNumC) « 
": bad number value for " « *nam « "=" « 
*val « endl ; 

cerr « "Parse error at line " « parse. lineNumC) « 
": bad number value for " « *nam « "=" « 
*val « endl ; 

return null; 

> 

haveRate = true; 
continue; 

} 

if( *nam == "Timeout" ) 

// TBD complain if repeated 

Timeout = strtodCval ->c_str() , &endPosn) ; 

ifC *endposn != '\0' ) 

{ 

cout « "Parse error at line " « parse. lineNumC) « 
": bad number value for " « *nam « "=" « 
*val « endl ; 

cerr « "Parse error at line " « parse. lineNumC) « 
": bad number value for " « *nam « "=" « 
*val « endl ; 

return NULL; 

} 

haveTimeOut = true; 
conti nue ; 

} 

if C *nam == "Dbg" ) 

// Dbg=nn — opt-- 0 disables 

// tbd complain if repeated 

dbgLev = strtoul (val ->c_str() , &endPosn, 0) ; 

ifC -endPosn != '\0' ) 

{ . . 

cout « "Parse error at line "« parse. lineNumC) << 

": bad number value for " « *nam « "="« *val « 

cerr « "Parse error at line " « parse. lineNumC) « 
": bad number value for " << *nam « "="« *val « 
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return null ; 



} 

} // end while 



haveDbg = true; 



// Verify that all of the required parameters have been parsed, 
if C ! haveType 

! haveProg 

! have Port 

! haveRate 

IhavePiD ) 

cout « "Parse error at line " « parse . li neNum() « 
": missing required parameter (s) : " « 



(haveType ? 

(haveProg ? 

(havePort ? 

(haveRate ? 

(havePiD ? 



Type=") « 

Prog=") « 

Port=") « 

Rate=") « 

PID=" ) « end! ; 



cerr « "Parse error at line " « parse. lin 
": missing required parameter (s) : ' « 



eNumQ « 



(haveType ? 
(haveProg ? 
(havePort ? 
(haveRate ? 
(havePiD ? 

return NULL; 



Type=") « 

Prog=") « 

Port=") « 

Rate=") « 

PID=" ) « end! ; 



// if the PMT PID parameter has been specified. 
if( havePMT ) 

// verify that the pmt pid can or has been associated 
// with the given program number. 

if( ! TrialMgr: : checkPmtForProg( pmtPid, progNum ) ) 

cout « "setup error at line " « parse. lineNumO 
« " pmt=" « pmtPid 

« " is invalid for program " « progNum « endl ; 

cerr « "Setup error at line " « parse. lineNumO 
« " pmt=" « pmtPid 

« " is invalid for program " « progNum « endl; 



} 



} 



return NULL; 



//At this point all of the required parameters have been 
//validly parsed. 

//create a new TcpEnc object, 
enc - new rcphncO ; 

//Depending on the stream type. 

switch( streamType ) 

{ 

case TsPkt: :AC3^VUDIO_STREAM: 
{ 
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// Mark this input stream as non-video. 
enc->d_isvideo = false; 

// Make a new Ac3Pes object and store it in the 
// 'd_pes' field inherited from 'Encoder'. 
enc->setPes( new Ac3Pes ); 

break; 

} 

case TSPkt: :MPEG2^AUDIO_STREAM: 
{ 

// Mark this input stream as non-video. 
enc->d_isVideo = false; 

// Make a new AudioPes object and store it in the 
// 'd_pes' field inherited from 'Encoder'. 
enc->setPes( new AudioPes ); 

break; 

} 

default: // All other types are video. 

// Mark this input stream as being video. 
enc->d_isVideo = true; 

// Make a new VideoPes object and store it in the 
// 'd_pes' field inherited from 'Encoder'. 
enc->setPes( new VideoPes ); 

} 

} 

// Set the mux output PID for the elementary stream. 
enc->setESPid( esPid ); 

// If the PMT PID has been specified for the program 
// that contains the elementary stream. 
if( havePMT ) 

// save the pmt pid in the 'd_pmtPid' field 
// inherited from 'Encoder'. 
enc->setPmtPid( pmtPid ); 

} 

else // The pmt PID is not specified. 

// Then the value of the 'd_pmtPid' field keeps 
// the initial value that it was given when the 
// object was created: TsPkt: :TS_null_pid, 
// see constructor for 'Encoder', 
j 

>. 

// If the video frame rate has been specified, 
if C haveHz ) 

{ ■ • • ■ ' ' 

// if this is not a video stream. 
ifC ! enc->d_i svideo ) 

cout « "Setup error at line " « parse. 1 i neNumO « 
": Hz= allowed only for video " « endl ; 

cerr « "Setup error at line " « parse. lineNumO « 
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": Hz= allowed only for video " « endl ; 
delete enc; 
return NULL; 

} 

// convert dtslnc units of 90 KHz to seconds. 
enc->setDtslnc( dtslnc / 90000.0 ); 

else // The video frame rate has not been specified. 
{ 

// Convert defaultDtsinc units of 90 KHz to seconds. 
enc->setDtsinc( defaultDtsinc / 90000.0 ); 

} 

// if the Timeout value has been specified. 
if( haveTimeout ) 

// Set the Timeout value in the object. 
enc->d_InputTimeOut = Timeout; 

> - 

else // The input time out was not specified. 

// use 2 seconds as the default. 
enc->d_InputTimeOut = 2.0; 

} 

// If the debug level has been specified. 

if( haveDbg ) 

{ 

enc->setDbgLev( dbgLev ); 

} 

// The Dtsoffset is the amount to add to the current output 
// time to arrive at an output time that avoids collisions 
// with data already held in the buffers waiting for output. 
// This needs to account for mux delay and is basically one 
// frame time plus an uncertainty time. 

enc->setEncDtsOffset( NORMAL_OUTPUT_DTS_STILL * enc->dtsinc() ); 

// Set the port number in the object. 
enc->d_PortNumber = PortNumber; 

enc->pes()->setPesBitRate( bitRate ); 

enc->setProgNum( progNum ); 

// Set the stream type in the Encoder object. 
enc->setstreamType( streamType ); 

return enc; 



/* 

NAMb: TcpEnc: : initialize 



PURPOSE : TO 
DESCRIPTION : 
EXAMPLE : 
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note: 



ASSUMES: 



HISTORY: 




void 

TcpEnc: :initialize() 

// tbd -- scan the file to extract a pes record with a 
// PES sequence header so we can get the actual bitRate 
// and frame rate. 



./* 

NAME: TcpEnc: :fillPesBuf 



PURPOSE: To read one payload unit from the TCP socket into 
the the Pes buffer. 



DESCRIPTION : See " IctvMpeg . h * . 

A PES packet is constructed from the incoming data if it is 
not already in PES form. 

The PES packet is moved into the PES input buffer using 
"addToPesBuf C) ' . 

when the PES packet is completed it is parsed into data 
fields held in the Pes object using the function 
' scanPesHeaderO ' . 

Returns non-zero if a valid PES packet has been read in 
else return zero if there was an error. 

Attempts to resync packets if there are errors detected. 



EXAMPLE: 



NOTE: 



ASSUMES: 



HISTORY: 




Fixed payload offset calculation to 
adjust for the size of the adaptation 
length field itself. 
Added support for Still Picture Format. 
More Still Picture Format revisions: 
duplicating picture header and 
incrementing temporal sequence field. 
Factored out P picture construction. 



bool 

TcpEnc: : fil 1 PesBuf O 

u8* 

u'8* 
u8* 
Int32 
Ulnt8 



p; 

AtPayload; 
AtEnd; 

Pay! oadByteCount ; 
ID, A, B, C, D , E, F, G; 
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Ulnt32 DataByteCount; 

Int32 i, j, TSPacketCount; 

u8 AdaptationFieldControl ; 

BOOL isAdaptationField; 

u8* AtPicture; 

u32 T^ictureBytecount; 

static const Ulnt8 ptsHeaderO[] = 

{ 0x00, 0x00, 0x01, // PES header start 

Pes: :mpeg_VIDEO_stream_id_base, // stream id for video 
0x00, 0x00, // packet length 

0x84, // marker=10, scram=00, 

// pri=0, a"lign=l, 

// copyrt=0,orig=0 

0x80, // PTS=1 , DTS=0 , ESCR=0 , 

// ESrate=0, trick=0, 

// addl=0,CRC=0,ext=0 
0x05, // PES header length 



}; 



// (pts only) 
0x21, 0x00, 0x01, 0x00, 0x01 // PTS (zero-value) 



Ulnt8 ptsHeader[ si zeof (ptsHeaderO) ]; 
double StartTime; 
double TimeNow; 
BOOL ok; 

// Clear the PES buffer. 
pes()->reset() ; 

// If debug info should be output, 
if C d_dbgLev & 2 ) 

// Get the current time before the frame is read in. 
StartTime = d__TimeStamp.getRelTime() ; 

} 

// Read the first six bytes of a 7 byte FIFO with 
// positions named "A" thru ' G ' . 
ok = ReceiveBytesC 6 ); 

// if a read error happened. 
if( !ok ) 

**'•/•/ : Just return with an error. 
**return( 0 ) ; 

}. ' " ' 

// Kef el" tt5the individual bytes read in. 
A = djFft'pWt'BUf TO] 
B = cLlnputBuftl] 
C = d_lnputBuf [2] 
D = d_InptffBOf [3] 
E = d_InputBuf [4] 
d_inputBuf [5] ; 

//until a valid packet prefix has been found. 
whileC 1 ) 

// The next byte into the FIFO, 
ok = ReceiveBytesC 1 ); 
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// If a read error happened. 
ifC !ok ) 

// Just return with an error. 
returnC 0 ) ; 

} 

G = *d_InputBuf ; 

// interpret the first byte in the FIFO as the packet ID. 
ID = a; 

// Interpret B, C, and D as the packet size value. 
DataBytecount = 

C ( (Ulnt32) B ) « 16 ) + 

C ( (Ulnt32) C ) « 8 ) + 

C (UInt32) D ); 

// If the packet has data and the size could be valid. 

if( DataBytecount && ( B < 2 ) ) 

{ 

// if id identifies the packet as packet_id_one_pes_as_ts 

// E is a TS packet sync byte. 

if( id == PACKET_ID_ONE_PES_AS_TS && 

E == SYNC_BYTE_VALUE ) 

// if the data length is an even multiple of the TS 
// packet size. 

if( C DataBytecount % BYTES_PER_TS_PACKET ) == 0 ) 
// Assume a valid TS type packet follows. 
// Get the remainder of the packet and 
goto GetRestOf Packet ; 

} } 

// Not a TS type packet but the other kinds haven't 
// be eliminated yet. 

// if E is the first byte of a pes packet start code prefix. 
if( e .== 0 && F == 0 && G == 1 ) 

// Assume a valid packet of some type follows. 

// Get the remainder of the packet and process it. 
goto GetRestOf Packet; 



//Shift the bytes in the input FIFO. 

A = B; B = C; C = D; D = E; E = F; F = G; 

} // End of while loop. 
////////////////// 

GetRestOf Packet:// Get the remainder of the packet the input buffer. 

////////////////// 

// Read in the data remembering that we already have the first 
// three bytes in E, F and G. 
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ok = ReceiveEytesC DataByteCount - 3 ); 



// if a read error happened. 

if C !ok ) 

{ 

// Just return with an error. 
returnC 0 ) ; 

} 

//At this point a packet is in the input buffer and it 
// has been partially qualified. 

// If the ID code is not recognized. 
if( ID != PACKET_ID_ONE_PES && 

ID != PACKET_ID_ES_OF_ONE_PES && 

ID != PACKET_ID_ONE_PES^S_TS && 

ID != PACKET_ID_STILL_PICTURE && 

ID != PACKET_ID_ACTIVATE && 

ID != PACKET_ID_DEACTIVATE ) 

{ 

// Could put more validation here. 

// interpret the packet as an elementary stream. 
ID = PACKET_ID_ES_OF_ONE_PES; 

} 

// Depending on the format of the input packet. 

switch( ID ) 

{ 

case packet_id_one_pes: // pes packet 

// Move the first three bytes to the Pes buffer: 
// these are the start Code bytes. 
addToPesBuf ( &E, 1 ); 
addToPesBufC &F, 1 ) ; 
addToPesBufC &G, 1 ) ; 

// Move the rest of the PES packet to the Pes buffer. 
addToPesBuf ( d_InputBuf , DataByteCount - 3 ) ; 

^ break; 

// Still Picture prefix format, 
case PACKET_ID_STILL_PICTURE: 

{ 

// Move the first three bytes to the Pes buffer: 
// these are the Start Code bytes. 
addToPesBuf C &E, 1 ); 
addToPesBufC &F, 1 ); 
addToPesBufC &G, 1 ) ; 

//Clear the PES header length fields: remember to 
// subtract 3 for the pes header bytes in E, F and G. 

d_TnputBuf[ PbS_PACKh I _L ENCi IH_HT BYTE - 3 ] = 0; 
d_TnputBuf [ PES_PACKET_LENGTH_LOBYTE - 3 ] = 0; 

// Refer to end of the data in the input buffer. 
AtEnd = d_InputBuf + DataByteCount - 3; 

// If dumping PES packet data to a log file, 
if ( d_dbgl_ev == 10 ) 
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// Write the ictv prefix header. 

fwriteC &a, Cu32) 1, (u32) 1, d_LogFile ); 

fwriteC &B, (u32) 1, (u32) 1, d_LogFile ); 

fwriteC &C, (u32) 1, (u32) 1, d_LogFile ); 

fwriteC &D, (u32) 1, (u32) 1, d„LogFile ); 

//Write the first three bytes. 
fwriteC &E, Cu32) 1, Cu32) 1, dj_ogFile ); 
fwriteC &F, Cu32) 1, Cu32) 1, d_LogFile ); 
fwriteC &G, Cu32) 1, Cu32) 1, d_LogFi]e ); 

// Write out the rest of the bytes. 
fwriteC d_lnputBuf, 

DataByteCount - 3, 

Cu32) 1, 

d„LogFile ); 

} 

// Find the picture header in the input buffer. 
AtPicture = 

TospecificstartcodeC 
d_inputBuf, 

// Address of the byte where the search 

// begins. 

// 

AtEnd, 

// Address of the first byte after 
// the last valid byte in the range. 

// 

Cu32) PICTURE_START_CODE ) ; 

// The value of the fourth byte of 
// the target start Code. 

// If no picture was found in the source data. 

if( ! AtPicture ) 

{ 

// Then return with an error. 

return( 0 ) ; 

} 

forC j =0; j < 1; j++ ) 

// Append a sequence end code. 
*AtEnd++ =0; 
*AtEnd++ =0; 
*AtEnd++ =1; 

*AtEnd++ = SEQUENCE_END_CODE ; 

■ } 

#if 1 // 12.01.99 TL Removed this section of code which is 
// called for in the GI spec but which doesn't work: 
//it could be that some parts of the dummy P frame 
//are not being constructed properly --more work 
//needed here to understand why this doesn't work 
// as specified. 



// Make a p picture that repeats the I picture. 
ppictureBytecount = 

MakeDummycodedPFrameC 

AtPicture, // The first byte of the Picture 
// Header of the I Picture used 
// as the source. 
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// 

AtEnd, // The first byte after the last 
// byte in the I Picture used as 
// the source. 

AtEnd ); // The destination buffer where 
// the P Picture will be 



// Advance the end-of-data address for the p frame 
// data. 

AtEnd += PPi ctureByteCount ; 

for( j = 0; j < 1; j++ ) 

// Append a sequence end code. 
*AtEnd++ = 0; 
*AtEnd++ = 0; 
*AtEnd++ = 1; 

*AtEnd++ = SEQUENCE_END_CODE; 

} 

// Move the rest of the PES packet to the Pes buffer. 
addToPesBufC d_InputBuf, AtEnd - d_lnputBuf ); 

break; 



case packet_id_es_of_one_pes: // ES packet 
{ 

// We need to first build a PES header with a PTS 
// field since this is missing. 

// Modify a standard copy of the PES header. 
memcpyC ptsHeader, ptsHeaderO, sizeof (ptsHeader) ); 

// If the PES packet length can fit into 16 bits. 
if( ( DataByteCount & Oxffff ) == DataByteCount ) 
{ 

// set the high byte of the pes packet length 
// field. 

ptsHeader [ Pes : : pes_PACKET_LENGTH_index ] = 
(Ulnt8) ( DataByteCount » 8 ) ; 

// set the low byte of the pes packet length 
// field. 

ptsHeader [ Pes : : PES_PACKET_LENGTH_INDEX + 1 ] = 
(UTnt8) DataByteCount; 



// Set the steamid in the PES packet header based 
// on the configured stream type. 
// TBD - WRONG: streamType and StreamID are two 
//different things. 

//ptsHeader [ stream_id_index ] = streanrrypeO ; 

// The correct value for the PTS will be inserted 
//when 'TcpEnc: rthreadStepO ' is called. 

// Insert the PES header into the PES buffer. 
addToPesBufC ptsHeader, sizeof (ptsHeader) ); 

// Move the first ES three bytes to the Pes buffer. 
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addToPesBuf ( &E, 1 ) 
addToPesBuf ( &F, 1 ) 
addToPesBuf ( &G, 1 ) 

// Move the rest of the ES segment to the Pes buffer. 
addToPesBuf ( d_lnputBuf , DataByteCount - 3 ) ; 

break; 

} 

case PACKET_ID_ONE_PES_AS_TS: // TS packets 

// Calculate the number of TS packets in the input 
// buffer. 

TSPacketcount = DataByteCount / bytes_per_ts_packet; 

// The first three bytes of the first TS packet are 
// in E, F and G. Refer to where E would be if it 
// were part of the first TS packet. 
P = d_InputBuf - 3; 

// For each TS packet in the input buffer. 
for( i =0; i < TSPacketcount; i++ ) 

// Get the value of the adaptation field control 

AdaptationFieldcontrol = ( P[ adapt__ctrl_index ] » 

// Determine if there is an adaptation field. 
isAdaptationField = AdaptationFieldcontrol & 2; 

// Calculate the beginning of the first payload byte 

// of the current TS packet. 

// Refer to the where the first payload byte would 

//in the TS packet if there were no adaptation 

AtPayload = p + adapt_j_en„index; 

// if there is an adaptation field. 
if( IsAdaptationField ) 

// Adjust the payload field address to 

// for the size of the adaptation field, 



size. 
- P ); 



} 



// for the size of the length field itself. 
AtPayload += p[ ADAPT_LEN_INDEX ] +1; 



//The size of the payload section of the TS packet 
// is calculated by subtracting the offset of the 
//first payload byte from the overall TS packet 

PayloadByteCount = BYTES_PER_TS_PACKET - ( AtPayload 



// Move the payload bytes to the Pes buffer. 
addToPesBufC AtPayload, PayloadByteCount ); 
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// Advance the TS packet pointer. 
P += BYTES_PER_TS_PACKET; 

} 

break; 



// Get the current time after reading a complete frame. 
d_CurrentFrameArrivalTime = d_TimeStamp.getRelTimeO ; 

// if debug info should be output. 
if( d_dbgLev & 2 ) 

// Report the time it took to read the frame. 

cout « Util : :formatFixed(d_currentFrameArrivalTime, 5) « 

" TcpEnc: :fillPesBuf : Time to read frame: " « 

Util : :formatFixed(d_CurrentFrameArrivalTime - startTime, 5) « 

" sees" « endl ; 

} 

// Parse the data in the PES header into fields in 
// the Pes object. 
pesO->scanPesHeader() ; 

// If debug info should be output. 
if( d_dbgi_ev & 2 ) 

cout « "TcpEnc: :fillPesBuf: Packet ID=" « ( (Ulnt32) id )« 
"DataByteCount= " « DataByteCount « " bytes" « 
end! ; 

cout « "TcpEnc Pes: pts=" « 

Util : ;formatFixed(pesO->ptsO) « 

" dts=" « util : :formatFixed(pesC)->dtsC)) « 

" dtsinc=" « dtslncC) « endl ; 

} 

// Every 24 frames. 

if( (d_dbgLev & 1) && (d_lnputFramecount % 24) == 0 ) 

// Get the current time after reading a complete frame. 
TimeNow = d_Ti mestamp . getRelTimeO ; 

// Report the time it took to read the frame, 
cout « Util : : format Fixed (TimeNow, 5) « 
" " « d_BytesReceived « 
" frame# " « d__inputFrameCount « endl; 

cerr « util : : format Fixed (TimeNow, 5) « 

" " « d_BytesReceived « 

" frame# " « d_InputFrameCount « endl; 

.}. ' ' ' ' ■■ ■ 

//Count how many PES data bytes have been received total . 
d_total PesData += pes()->inPosn() ; 

// Enter or exit still Frame Mode depending on the packet 
// just received. 

d_lsStillFrameMode = (ID == PACKET_iD_STiLL_PICTURE ); 

// The DtsOffset is the amount to add to the current output 
//time to arrive at an output time that avoids collisions 
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// with data already held in the buffers waiting for output. 
// This needs to account for mux delay and is basically one 
// frame time plus an uncertainty time. 

// Adjust the normal dtsoffset depending on whether in 
// still frame or regular mode. 
if( d_lsstillFrameMode ) 

{ 

// More time is needed on average for streams with 
// only I Pictures . 

setEncDtsOffsetC normal_output_dts_still * dtslncO ); 

} 

el se 

// Two frame times is adequate for streams with 
// I and P Pictures. 

setEncDtsOffsetC normal_output_dts * dtslncO ); 

} 

// Count how many PES packets have been received total . 
d_InputFrameCount++ ; 

returnC true ) ; 



name : TcpEnc: :GetNextFrame 



PURPOSE: To read the next frame from the input or re-use 
the last frame if no input data is available. 

DESCRIPTION: Also monitors how long it's been since the 
last input so that the connection can be closed on a 
timeout. 

EXAMPLE : 
NOTE: 
ASSUMES : 

HISTORY: S^^BP 

AHtHV Fixed time out. 
*/ 

void 

TcpEnc: :GetNextFrameO 

{ ' ' 

double TimeNow; 

double El apsedTimelnSeconds ; 

double Timeoutseconds; 

// if connected and no data available. 

i f ( disconnected && d_BytesAvail able == 0 ) 

{ 

//Get the current time. 

TimeNow = d_Timestamp.getRelTimeO ; 

// Calculate the elapsed time in seconds. 

El apsedTimelnSeconds = TimeNow - d_L_astlnputTime; 

// if this is the first frame. 
if( d_isFi rstFrame ) 
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{ 

// Allow five times the normal time out. 
TimeOutSeconds = cLlnputTimeOut * 5.0; 

else // This is not the first frame. 

// Use the normal time out period. 
TimeOutSeconds = d_inputTimeOut; 

} 

// if the expected data takes longer than the 
// read timeout period. 

if( ElapsedTimelnSeconds > TimeOutSeconds ) 

// Close the TCP connection. 
CloseconnectionO ; 

} 

} 

// if this is still frame mode. 
if( d_isstillFrameMode ) 

//if there is a current frame and there are bytes 
// available for reading from the socket. 
if( d_isCurrentFrameAvailable && 

disconnected && 

d_BytesAvai Table ) 

// Then clear the frame available flag so that 
// a new frame will be read rather than repeating 
// the current frame. 
d_lsCurrentFrameAvai Table = 0; 

} 

// If we can re-use the current frame. 
if( d_lsCurrentFrameAvai TabTe ) 

// Return treating the previous frame as repeat frame, 
return ; 

} 

} 

// if there is no current frame to process. 
if( ! d_lscurrentFrameAvai TabTe ) 

// if data is avai TabTe to be read. 
if( disconnected && d_BytesAvai Table ) 

■ { 

// Try to receive one frame. 
d_IsCurrentFrameAvai TabTe = fiTT PesBuf O ; 

} . 

.}•:. 

//if a valid frame still has not been received, 
i f( ! d isCurrentFrameAvai lable ) 

.{: . . . . ■ . . . ■ ■ 

// Return without doing anything else, 
return ; 

} ' • ' . • ' 

// If the current frame should be treated as if it 
// were the very first frame ever processed. 
if( d_IsFi rstFrame ) 
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// if this not Still Frame Mode. 
if( ! cLlsStill FrameMode ) 

// if the current frame doesn't have a pts value, 
if C ! pesO->ptsFlagO ) 

// Then discard the current frame. 
d_lsCurrentFrameAvai Table = 0; 



} 



} 



} 

/*- 



name: TcpEnc: : Recei veBytes 




PURPOSE: To receive a specified number of bytes to the 
input buffer. 

DESCRIPTION: Returns only after the specified number of 
bytes has been received from the TCP socket. 

The input data is placed at the beginning of the input 
buffer, 'd_InputBuf 1 . 

if the input buffer is too small to accomodate the required 
data it is reallocated. 

EXAMPLE: 
NOTE: 

ASSUMES: There is no data currently in the input buffer. 
HISTORY: 

Added error return flag and reporting. 
Added use of Socket_Data_Avai 1 so that 
disconnections can be detected without 
hanging in a blocking read. 

V 

BOOL 

TcpEnc: : Recei veBytes ( u32 BytesToRead ) // How many bytes to read. 
{ 

u8* AtBuf; 
u32 BytesReadThisPass ; 
double TimeNow; 
double ElapsedTime; 
s32 BytesAvai lable; 

// if the socket isn't connnected. 
if C ! disconnected ) 

-.{■■■ • • • ■ ■ 

// Return fai lure 
return ( 0 ) ; 

■ ■ } ' ." " ' ■ ' - ■ ■ ' ' 

// if the expected number of bytes is more than the 
// space available in the input buffer, 
if C BytesToRead > d_lnputBufSize ) 
{ 

//if there is an input buffer to free. 
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if( d_lnputBuf ) 

// Deallocate the input buffer. 
freeC cLlnputBuf ); 

} 

// Mark the input buffer as missing. 
cLlnputBuf = 0; 

} 

// if the input buffer is missing. 
if( ! cLlnputBuf ) 

{ // All oca t e an input buffer !ar g e enough for the 

// expected bytes. 

d_InputBuf = (u8*) mallocC BytesToRead ); 

// update the size of the input buffer. 
d_lnputBufsize = BytesToRead; 

} 

// Refer to the input buffer's first byte. 
AtBuf = d_lnputBuf ; 

// until the required number of bytes have been received. 
whileC BytesToRead ) 

// Get how many bytes are currently available. 
BytesAvai Table = (s32) Socket_Data_Avai 1 ( d_Socket ); 

// If there was an error testing for available data. 

if( BytesAvai Table < 0 ) 

{ 

// cTose down the connection, 
goto cToseSocketOnError; 

eTse // No error testing for avai Table data. 
{ 

//if there is data available to read. 
if( BytesAvailable ) 

// If there are more bytes available than 
// are needed . 

if( BytesAvailable > BytesToRead ) 

// Only read what is required. 
BytesAvailable - BytesToRead; 



// Read as many remaining bytes as are 
// available to the input buffer. 
BytesReadThispass = 

Socket_Read( d_socket, AtBuf, BytesAvailable 



// If the socket quits gracefully or there was a 
//read error. 

if( C BytesReadThispass == 0 ) || 

C BytesReadThispass == socket_error ) ) 
{ ' ■ 

//close down the connection. 

goto CToseSocketOnError ; 

} 
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else // Some data was read. 

// Note the time when the data arrived. 
d_LastInputTime = d_TimeStamp.getRe"lTimeO ; 

// Account for the bytes read. 
BytesToRead -= BytesReadThisPass; 

// Advance the destination in the buffer. 
AtBuf += BytesReadThisPass; 

// Update the running total for the encoder. 
d_BytesReceived += BytesReadThisPass; 

} 

} 

else // No data currently available. 
{ 

// Sleep ten milliseconds. 
SleepC 10 ) ; 

// Get the current time. 

TimeNow = d_TimeStamp.getRelTime() ; 

// Calculate the elapsed time in seconds. 
ElapsedTime = TimeNow - d_LastInputTime; 

// if the expected data takes longer than the 

// read timeout period. 

if( ElapsedTime > d_lnputTimeout ) 

// Close down the connection, 
goto CloseSocketOnError ; 

} } 

} 

} 

// All bytes requested have been read. 
returnC 1 ) ; 

///////////////////// 
Cl oseSocketOnEr ror : // 

///////////////////// 

// If debug info should be output. 
if( d_dbgl_ev & 2 ) 

// Report the error. 

//Report the time it took to read the frame, 
cout « 

" TcpEnc :: Recei veBytes error: Closing connection." 
« end I ; 

■ . cerr « " 

" TcpEnc: : Recei veBytes error: Closing connection." 
« endl ; 

} . " 

■■//■close the network socket. 
CloseconnectionO ; 

// Return 0 to indicate a read error. 

Page 36 



TcpEnc.cpp 

returnC 0 ) ; 

} 

/* 

name: TcpEnc: : ResetOutputDts 



PURPOSE : TO reset the value used to schedule when frames 
can enter the the mux input queue. 

DESCRIPTION: The OutputDts is the earliest time when a frame 
can leave an encoder's waiting queue for input into the 
mux. 

stc is the point in time where a byte is leaving the mux. 

initialize the outputDTS to be the current stc adjusted by 
the amount of time it takes a frame to flow through the 
mux, phase adjusted to an integral frame time. 

EXAMPLE : 

note: 

ASSUMES : STC time refers to the byte currently leaving 
the mux. 

HISTORY: flMl 

v 

voi d 

TcpEnc: : ResetOutputDts () 

double stc, DtsOffset, OutputDts, Dtslnc; 

// Get local copies of the values we need. 
Stc = Uti I : :stcTimeO ; 

Dtsoffset = dtsOffsetO; 
Dtslnc = dtsincO ; 

// Calculate the normal outputDts. 
OutputDts = stc + Dtsoffset; 

// FRAME PHASE NORMALIZATION RULE: The value of OutputDts 

//is used as a basis for the pts and DTS timestamps 
// which must be in terms of integral frame times. This 
// next section is responsible for snapping the Dtsoffset 
// to the nearest integral frame 

//Calculate the nearest integral frame time. 
OutputDts ■=.'.■ 

floorC (outputDts + (Dtslnc * . 5) ) / Dtslnc ) * Dtslnc; 

// Set the new outputDts. 
setoutputDts( OutputDts ) ; 

■} ' - ' 

NAME: TcpEnc: : setQuitRequest 



PURPOSE: To 
DESCRIPTION : 
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EXAMPLE: 
NOTE: 
ASSUMES: 

j HISTORY: ^ 

voi d 

TcpEnc: : setQuitRequestC bool rhs ) 

DmThread: : setQuitRequest(rhs) ; 

} 

/* 

name : TcpEnc: : start 



PURPOSE : To 
DESCRIPTION : 
EXAMPLE : 
NOTE: 
ASSUMES : 

HISTORY: 

-V 
voi d 

TcpEnc: : start C) 

threadCreate() ; 

} 

/* 

NAME : TcpEnc: : stop 



PURPOSE: TO 
DESCRIPTION : 
EXAMPLE: 
NOTE : 
ASSUMES: 
HISTORY: 



boo I 

TcpEnc: :stop() 

{ ' 

bool rslt = true; 

i f C runni ng() ) 
{ 

rslt = stopThreadO; 

} 
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// TBD 

return rslt; 

} 

/* 

name: TcpEnc: :threadlnit 



PURPOSE: To 
DESCRIPTION: 
EXAMPLE : 
NOTE: 
ASSUMES : 
HISTORY: 



void 

TcpEnc: :threadlnit() 
{ 

) 

} 

/*- 



NAME: TcpEnc: :threadstep 



PURPOSE : To convert one PES packet to TS packets, feed 
them into the multiplexer and read another PES 
packet. 

description : inserts current pts/dts if the pes packet has 
those fields. 

EXAMPLE: 

note: 

ASSUMES: 

HISTORY: From Ac3Enc and IbmDemoEnc . cpp . 

Added special Still Frame Mode handling 
for the PTS. 

Factored out socket connection code. 
Added frame repeat for still frame mode. 
— __ — __ ___ — . ___ . */ 

voi d 

TcpEnc: :threadstep() 

{ . ' ' . . 

//Wait for and make TCP connection if possible. 
WaitForConnectionQ ; 

// Measure how many bytes are currently available from 
// the TCP socket. 

d_BytesAvai 1 abl e = (s32) socket_Data^wail ( d_Socket ) ; 

// if there was an error testing for available data. 

if( d_BytesAvailable < 0 ) 

{ 

// Then there is no data available. 
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d_BytesAvai Table = 0; 

// close the TCP connection. 
CloseConnectionC) ; 

// Don't return here because we may want to keep 
// repeating the last frame we have. 

} 

// Read the next frame to send. 
GetNextFrameO ; 

// If there is a current frame to process. 
if( d_lsCurrentFrameAvailable ) 

{ 

// wait for next frame time. 
waitForNextFrameTimeO ; 

// Keep the time scheduled for inputing the current 
// frame into the mux within bounds. 
Normal izeoutputDts C) ; 

// At this point we have a valid frame and the outputDts value 
// applies to the current frame. 

// Adjust the any pts/dts values in the current pes frame. 
AdjustFrameTimeStampsO ; 

// convert pes buffer to TS packets and feed them into 
// the wait queue that feeds the mux input. 
enqueuePesBuf () ; 

// Count how many frames have been queued for output. 
d_OutputFrameCount++ ; 

// if this is not still frame mode. 

if C ! d_lsstillFrameMode ) 

{ 

// Clear the frame availability flag so that the 
// same frame won't be sent multiple time. 
d_lsCur rent FrameAvail able = 0; 

} 

// clear the first frame flag since we've completed 
// all initialization required if this was the first 
// frame. 

d_IsFi rstFrame =0; 

■■} 

J 



NAME: TcpEnc: : showSetup 



purpose: To display setup and statistics as text. 

DESCRIPTION : 
EXAMPLE : 
NOTE: 
ASSUMES: 

Page 40 



TcpEnc.cpp 

history: WU/m 
*/ 

void 

TcpEnc: : showSetupC ostream &strm ) const 
{ 

// if the output stream is valid. 
if( strm.opfxQ ) 

strtn « "{class TcpEnc " « threadNameC) « 
strm « " Reading " « ( d_isVideo ? " Video" : " Audio" ) 

« " PES packets from port=" « d_PortNumber « 

" output PID=" « esPidC); 
strm « endl ; 

// Show the generic encoder setup. 
Encoder: : showSetup(strm) ; 

strm « "}" « endl ; 

// Flush the output stream. 
strm.osfxC) ; 



} 



NAME : TcpEnc : : showStats 



PURPOSE: To 
DESCRIPTION : 
EXAMPLE: 
NOTE : 
ASSUMES : 
HISTORY: 



Added line for number of packets sent. 



void 

TcpEnc: : showStats (ostream &strm) const 

// if the stream is valid, 
if C strm.opfxO ) 

strm « "TcpEnc " « threadNameC) « 
strm « " Read " « d_lnputFrameCount « " PES packets C " 

« util : :formatFixed(d_totalPesData/double(l<<20) ,3) 
« " MB) " « endl ; 

strm« "TcpEnc " « threadNameC) « ":"; 
strm « " sent " « d_outputFramecount « 
" PES packets" « endl; 

Encoder: : showStats Cstrm); 

// Flush the output stream. 
strm.osfxC); 

} 

} 
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/* 

NAME: TcpEnc: :waitForConnection 



PURPOSE : To wait for an incoming TCP connection, make 
the connection and prepare for frame data. 

description: if the socket is already connected then nothing 
is done. 

if not connected then: 

1. Enter the state where no frames have yet been processed. 

2. Initialize and bind a socket. 

3. Configure the socket as blocking. 

4. Configure a 128k receive buffer instead of the default 
8K buffer. 

5. Wait for and accept an incoming connection on the 
configured port for the TcpEnc instance. 

6. On connection enter the connected state. 
EXAMPLE : 

NOTE : 
ASSUMES : 

HISTORY: JHI^P Factored out of TcpEnc: : threadStepO . 

Added default to still Frame Mode on 
connection. 

Added opening of special log file if 
debug level is 9. 




void 

TcpEnc: :WaitForConnection() 



-V 



{ 



int status; 
unsigned long blocking; 
s32 Err; 

// if debug level is 9 and LOG„RECORD_COUNT frames have 
// been collected. 

if( d.dbgLev == 9 && d_LogRecordCount == L0G_RECORD_count ) 
{ 

// Disconnect and output the data. 
CloseConnectionO ; 

} . ' ■ 

// If the TCP socket is not connected, 
if ( disconnected == 0 ) 

{ ' ■ ' ' ■ ■ ' ' ' 

//initialize a TCP socket and bind it to the 
//configured port number. 
d_ListenSocket = 

Socket_im't^\nd_Bind( (int32) sock_STREAM, d_PortNumber ); 

// if there was an error creating or binding the 
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// socket. 

if( d_Li stenSocket <= 0 ) 

// If debug info should be output. 
if( d_dbgLev ) 

cout « "WaitForConnection error: cannot bind port 

d_PortIMumber « end! ; 

cerr « "WaitForConnection error: Cannot bind port 
d_PortNumber « endl ; 

} 

// Return without connecting, 
return; 

} 

// Make the listening socket a blocking socket. 

// set 'blocking' to zero to indicate that the socket should 
// be blocking, 
blocking = 0; 

status = ioctlsocketC d_Li stenSocket, (long) FIONBIO, Sblocking ); 

// if 'int' is less than four bytes long. 
if( sizeofC int ) < 4 ) 

// Make a 30000 byte kernel TCP receive buffer for the 



SO_RCVBUF, 30000 ); 

} 

el se 
{ 

socket . 



SO_RCVBUF, 128 * 1024 ); 

} 



Err = Socket_SetSockOpt( d_Li stenSocket , SOL_SOCKET, 

// Make a 128k byte kernel TCP receive buffer for the 
Err = Socket_SetSockopt( d_Li stenSocket, SOL_SOCKET, 



size " « end! ; 
size " « endl ; 



// If there was an error changing the buffer size. 

if C Err ) 

{ 

// close the code to release OS resources. 
socket_close( d_Li stenSocket ); 

//Mark our socket as missing. 
d_Li stenSocket =0; 

// If debug info should be output, 
if C d_dbgl_ev ) 

{ ■ ■ ' • 

// Report the error. 

cout « "WaitForConnection error setting rev buffer 
cerr « "WaitForConnection error setting rev buffer 

• } • 

// Return without connecting, 
return ; 
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} 

// Wait here for an incoming connection. 

cLsocket = socket_l_i sten_Accept( d_ListenSocket, 0 ); 

// if a valid connection was made. 

if( d_socket ) 

{ 

// Do the buffers for this socket also need to be 

reconfigured? 

// Note the socket connection status, 
disconnected = 1; 

// Treat the connection as an input for time out purposes. 
d_LastInputTime = d_TimeStamp. getRelTimeO ; 

// Then treat the next frame as if it were the first 
// frame ever processed. 
d_lsFi rstFrame = 1; 

// Then there is no valid current frame available. 
d_IsCurrentFrameAvai Table = 0; 

// Default to not being in still frame mode. 
d_IsSti 11 FrameMode = 0; // 1; 

// If the debug level is 9. 
if( d_dbgLev == 9 ) 

// Create a buffer big enough to hold data for 
// log records. 
d_LogBuffer = (u8*) 

mallocC LOG_RECORD_COUNT * 

sizeofC TcpLogRecord ) ); 

// Set the end of buffer marker. 
d_LogBufferEnd = d_LogBuffer; 

// initially there are no records. 
d_LogRecordCount = 0; 

} 

else // No log buffer. 
{ 

// Clear the log file field. 
d_LogBuffer =0; 
d_LogBufferEnd =0; 



// If dumping PES packet data to a log file. 
if( d_dbgLev == 10 ) 
■ '{ . ' ' 

// Then open a special log file. 

d_LogFile = fopenC "TcpLog . pes" , "wb" ); 

} .V ... .. ' ' 

else //a connection error occurred. 

{ ' ' 

// close the listening socket. 
socket_close( d_Listensocket ); 

// Mark our socket as missing. 
d_Li stenSocket =0; 
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// If debug info should be output. 
if( d_dbgLev ) 

cout « "threadinit error: Cannot accept on port 

d_PortNumber « end! ; 

cerr « "threadlm't error: Cannot accept on port 
d_PortNumber « endl ; 



// Return without connecting, 
return; 



} 

/*- 



NAME: TcpEnc: :WaitForNextFrameTime 



PURPOSE: To meter mux input and sync the outputDTS counter 
to the STC. 



description: This procedure regulates the input of a frame 
into the mux and also as an indirect result it syncs the 
outputDTS counter to the STC counter through the amount of 
time used to make the thread sleep. 

Uses expontial moving averages of the STC and OutputDts 
to smooth out short term sample fluctuations. 

example: 

NOTE : 

ASSUMES : STC time refers to the byte currently leaving 
the mux. 



HISTORY: HflM^k Copied from SimEnc: :threadstep. 

^HHMcleaned up initial frame condition. 

void 

TcpEnc: :wai tForNextFrameTi me () 



{ 



F64 Stc, DtsOffset; 

f64 Odt, Wait, Actual Wait; 

static f64 StcX, Odtx; 

f 6-1 wt; 

//Set the smoothing weight depending on the output 
// frame .number: ■■initially very responsive to short 
// term differences and later less so. 
if( d_OutputFrameCount < 31 ) 

Wt = .5; ■ " ■■ 

} 

else // At least 30 frames have been output. 

{ 

wt = .1; 

} 
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// Get values we need to local variables. 
Stc = Util : :stcTimeO ; 

Odt = outputDtsO ; 

Dtsoffset = dtsoffset O; 

// if the current frame is the first frame. 

if( d_IsFi rstFrame ) 

{ 

// set the initial outputDts value. 
ResetoutputDtsC) ; 

// Get the current outputDts value. 
Odt = outputDtsO; 

// Set the initial smoothed values to the 
// actual values, 
stcx = stc; 
odtx = odt; 

} 

else // Not the first frame. 
{ 

// Update the smoothed values. 
StcX = ( Wt * Stc ) + ( ( 1.0 - wt ) 
Odtx = ( Wt * Odt ) + ( ( 1.0 - Wt ) 

} 



StcX ); 
Odtx ); 



// we need to calculate how long it will be before 
// the next frame can be queued: OutputDts was 
// incremented the last time enqueuepesbuf () was 
// called so it refers to the time when the next 
// frame should enter the mux from the waiting 
// buffer. 

//Wait = Util : :timeDiff ( Odt - ( Stc + Dtsoffset ) ); 
Wait = Util : :timeDiff ( Odtx - ( StcX + Dtsoffset ) ); 

// if the thread should delay. 
if( wait > 0.0 ) 
{ 

// wait until it's time to input the current frame. 
^ threadsleepC wait ); 

// if log records are being collected, 
if C d„dbgLev == 9 ) 

// Calculate the actual wait time. 

Actualwait = Util : :timeDiff C Util : :stcTimeO - Stc ); 

//Collect the data for the current frame. 
TheLogRecord.stc - stc; 

TheLogRecord.Requestedwait = wait; 
ThetogRecord .Actualwait = Actualwait; 

TheLogRecord .OutputDts = Odt; 

TheLogRecord.TnputFrameNumber = d_InputFrameCount; 

// Append the log record to the log buffer. 
memcpyC d_LogBufferEnd, 

(u8-J &Thel ogRecord, 

sizeofC TcpLogRecord ) ); 

// Account for the new record just added. 
d_LogBufferEnd += sizeofC TcpLogRecord ); 
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cLLogRecordCount += 1; 

} 

/* 

NAME: ToSlice 



purpose : To find the address of the next picture Slice in a 
range of bytes. 

DESCRIPTION: Returns the address of the first byte of the 
Start Code of the next Slice header in a buffer or zero 
if no slice code was found. 

EXAMPLE : 

AtStartCode = ToSliceC Lo, Hi ); 

NOTE: 
ASSUMES : 

HISTORY: (■■B from 'ToNextStartCodeO ' . 
*/ 

// Returns the address of the 
// first byte of the slice start 

u8* // code or zero if none was found. 

TosliceC 

u8* lo, // Address of the byte where the search 

// begins. 
// 

u8* Hi ) // Address of the first byte after 

// the last valid byte in the range. 

{ 

u8 A, B, C, D; 

// Get the first three bytes. 
A = *Lo++; 
B = *Lo++; 
c = *lo++; 

// As long as the current byte is valid. 

whi le( lo < Hi ) 

{ 

// Get the value of the fourth byte. 
D = *Lo++; 

// if A, B , and C match the first bytes of 
// a start code and the fourth byte matches 
//a slice code value, 
if C C A == 0 ) && 

C B == 0 ) && 

C c l ) && 

C D >= (u8) FIRST_SLICE_START„CODE ) && 
C D <= (U8) LAST_SLICE_START_CODE ) ) 



{ 



// Then we have found the start code. 

// Return the address of the first 
// byte of the start code. 
return( Lo - 4 ) ; 
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// Shift the bytes in the input FIFO, 
A = B; B = C; C = D; 

} 

// No start code was found. 

// Return zero, 
return ( 0 ) ; 



NAME: Tospecificstartcode 



PURPOSE: To find the address of the next matching MPEG Start 
Code in a buffer. 

DESCRIPTION: Returns the address of the first byte of the 
next matching Start Code or zero if none was found. 

EXAMPLE : 

Atstartcode = 

ToSpecificStartCodeC AtBuf, 

AfterBuf , 
MatchValue ) ; 

NOTE : 
ASSUMES: 

HISTORY: MMMi from 'ToNextStartCodeO ' ■ 
*/ 

// Returns the address of the 
// first byte of the target start 
u8* // code or zero if none was found. 

Tospeci f i cstartcode ( 

u8- Lo, // Address of the byte where the search 

// begins. 
// 

u8* Hi, // Address of the first byte after 

// the last valid byte in the range. 

// 

u32 MatchValue )// The value of the fourth byte of 
// the target Start Code. 

{ 

u8 A, B , C, D; 

//Get the first three bytes. 
A = *Lo++; 
B = -L0++; 
■ C =. -I o++; 

// As long as the current byte is valid, 
whi le( Lo < Hi ) 

{ ■ ■ ■ . ■ ' ' . . 

// Get the value of the fourth byte. 
D = *Lo++; 

// If A, B , and C match the first bytes of 
// a start code and the fourth byte matches 
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// the target value. 
if( ( A == 0 ) && 

C B == 0 ) && 
( C = 1 ) M 
( D == (u8) Matchvalue ) ) 

// Then we have found the start code. 

// Return the address of the first 
// byte of the start code. 
return( Lo - 4 ) ; 

} 

// shift the bytes in the input FIFO. 
A = B; B = C; C = D; 

} 

// No start code was found. 

// Return zero. 
returnC 0 ) ; 

} 



// 
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1. Introduction 

This document describes the features for the ARCTOS Information Service. 

1.1 Purpose and Scope 

This document describes the functional requirements, design, testing, and planning issues necessary to 
properly release the Arctos project. Both engineering and QA will use this document as a guide for 
implementation and verification of Arctos project. All details contained in this specification should be 
followed exactly. If it is discovered during implementation that changes to these details are required, the 
changes must be reviewed, and this document modified to reflect the actual differences. In addition, no 
functionality other than that contained in this document will be implemented without the same review 
process. 

1.2 Related Documents 

As other documents are referenced within the body of this document, they will be included below for 
reference. 

Document # Publisher Title Author 

TS00I-01 ICTV Arctos Test Specification Arctos Team. 

1.3 Omissions and Uncertainties 



1.4 Confidentiality 

This document is the confidential proprietary property of ICTV, Inc. The information contain herein may 
not be disclosed, copied, distributed or otherwise utilized without the express written permission of ICTV, 
Inc. 

1.5 Methodology and Conventions 

Where I have specific questions or issues, they will appear in BOLD ITALICS. These issues will be 
removed from the document as they are addressed before the final approved document. 



None. 
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2. Project Plan 

This section defines the project plan for this document. All known planning and resource issues are 
discussed in this section. 

2,1 Project Team 

The following team members will be involved in production of this product. 



2.1.1 Software Development 

Bob Sigmon 
Lena Pavlovskaia 
Allan Moluf 
Jack Schabel 
Tim Lee 
Eran Landau 
Greg Brown 

2.1.2 Quality Assurance 

2.1.3 Marketing 

2.1.4 Technical Support 

2.1.5 Sales 



2.2 Schedule 

The following project schedule will be employed for these releases: 

• IBBMBPArchitechture/Functional Spec complete, reviewed and ready to go 

• <HBBB| Tech Specs (Class diagrams, etc.) complete and reviewed (Bob, Lena, Eran) 

• ^BWi Arctos Server, Carousel Explorer, Alert Manager, Adminstrator Betas 

• '■■MBPUgos Interface 

• 12/17/1999 Mux Interface Beta 

• 12/20/1999 System testing and bug fixing begins. 

• 12/31/1999 System complete 



Other milestones: 

* Hardware available and Software installed 
« 12/20/1999 Test Plan 

• 12/27/1999 Installation, backup and maintenance documents/scripts 
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3. Project Requirements 
3.1 Functionality 

Arctos is an HTML slide show generator that broadcasts on digital MPEG II channels. 

1 . Must be scalable and able to support at least 20-30 carousel channels. 

2. Carousel intervals must have a minimum update interval to prevent congestion on the system. Content 
that is updated at too high of a rate will be dropped. 

3. Content will be either local or remote. 

4. The channels may be offered in a tiered fashion whereby all digital customers receive a "basic" level of 
services and have the opportunity to upgrade to a premium level (or levels). 

5. Must be able to integrate with either a national or local headend. 

6. Consume less than 2MHz (per 20 - 30 channels) on the cable system. 

7. Channel content will be developed using any technology supported by Internet Explorer 

8. System modifications and status functionality should be accessible through the WEB client. 

9. Must have an up time of 99.95%. 

10. Must have the ability to set channel parameters referenced in ChanneIInterfaceToMUX.doc 

1 1 . Notification of changes to HITS virtual channel numbers will by synchronized (Method TBD) 

12. The system will send alarms and alerts through an SNMP interface to the head-end(s) 

13. Administration features will be protected to the content providers. 

Issues: 

1 . Is there other PSI information neede in the stream. 

2. What abou PID 0, 1 , return PID, etc. 
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4. Installation 



4.1 Initial Installation and Setup 

ICTV INC will do installation. The servers will be set up at the home office and delivered in a state ready 
for 'plug in'. Power (and UPS), network connection to the Internet (and firewall), and connection to the 
cable system (HITS), is expected to be provided by the customer. The customer will also provide IP 
addresses (3). Access to the Administration pages will be through the Internet via a browser and system 
messages will be available through SNMP. 



4.2 Maintenance 

ICTV INC will provide software maintenance. In order to keep our targeted uptime, the secondary server 
will be 'disconnected' from the cluster and the software upgrades will be placed on the secondary server. 
After a successful install, the secondary server will be brought back into the cluster and the primary server 
will be brought down, forcing the secondary server to become the primary server with the new software. 
Then maintenance will then be applied to the other server and it will be brought back on line as the 
secondary. The current version of the software will be accessible via the Admin Pages. At some point, 
maintenance may be provided remotely, but not initially. SNMP messages will be sent notifying the 
interested parties that maintenance is being performed. 
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5. Design Specifications 
5.1 Hardware and Software 

The Arctos project will be comprised of two Windows NT 4.0 SP6 or later Systems, one of which is a 
primary server and one a secondary server 

Each server will have the following hardware configuration: 

1 . Dual Pentium PHI 600 processor (or faster) 

2. 10 GB Hard drive 

3. 512 MB RAM 

4. AGP Voodoo 3000 Graphics card 

5. Vivid 2-Channel QAM (Could be De-Hi also) 

6. CD-ROM 

7. 100MPS Network card 

8. 1.44 Floppy Disk 

9. Zip drive for backup 

Each Server will have the following software configuration: 

1. Windows NT4.0 SP6 

a. TCP/IP 

b. WLBS (Load Balancing) 

c. SNMP 

2. IIS 4.0 

3. IE5 5 

4. MPEG encoder (Ligos Software/GI Hardware) 

5. ICTV Digital Mux Software 

6. ICTV Arctos Software 

a. Arctos Server 

b. Carousel Explorer 

c. Alert Manger 

d. Administrator 

7. Plug-ins for displaying content including but not restricted to Flash, RealVideo, QuickTime, etc. 

These servers will be connected within their own local network and also to the internet through the head end 
topology. 

5.1.1 Environment 

The software environment will consist of Windows NT 4.0 SP6 with Load Balancing software (wbls). The 
code will be written in C++/Java with administration tool(s) available as HTML/XML forms from a 
Browser. COM/DCOM will be used to communicate between the services and processes within each 
server. TCP/IP will be used as the main transport protocol. IIS (Internet Information Server) will be used as 
the web server. SNMP will be the 'alert' mechanism so that any remote console can view server status at 
any time. The machines will be 'clustered' together using the load balancing option on NT. They will 
share a virtual address, which will be the well-known address of the system. Each server will also have 
individual addresses, although not well known, so that they can be addressed directly. One will be 
designated as a primary server and one as a secondary server, although this will be only an initial 
designation and could change over time (see Failsafe section). All parts of the architecture will be a 
duplicate on each machine, and functionality will be an exact copy. 
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MPEG Encoding will done by the Ligos software package (or the GI Encoder hardware), and the MUX 
software will be the same product used in our digital interactive system. Each piece of software will 
maintain it's 'Version' number and will return it when asked. Later this can be used for software 
maintenance and troubleshooting. 
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5.1.2 Arctos Hardware/Network Architecture 
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5.2 Arctos Server 

Arctos Server is actually MS IIS 4.0. It controls all outside client access to Arctos. 



5.2.1 Functionality 

1. Security 

IIS Internet Manager performs authentication for the client. 

2. Web Server functions 

Default IIS WEB site will have virtual paths to the Arctos directories where the actual content is stored. 

3. CGI programs executed by Arctos Server: 

1 . Admin Pages\Channel Map CGI 

2. Admin Pages\System Status CGI 

3. Event Log Viewer CGI 
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5.3 Carousel Explorer 

The Carousel Explorer will be responsible for running the carousel scripts (HTML, XML...) and 
forwarding the captured screen shots to the MUX. In addition, Carousel Explorer will be the console 
application for Arctos and will include functionality for system maintenance and logging. 



5.3.1 User Interface 

Carousel Explorer will be an MDI application where there is a document and view for every channel. The 
user interface will have the following components (see image below): 

1. All the views will be displayed in Carousel Script Queue position. Each view will contain a browser 
control window for displaying the URL. 

2. The status bar will contain current system information and distinguish between the primary and backup 
servers. 

3. The Channel Map Frame will provide current status information on every channel. The channel map 
can also be modified through the Admin CGI in a browser control the will be displayed over the 
Channel Map Frame. 

4. The Alert / Log Frame will provide status information as well as system alerts. 

5. The Main Toolbar will provide access to various system maintenance and management dialog boxes. 
These dialog boxes will be displayed over the Alert/Log frame. 
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5.3.2 Interfaces 

1. Arctos Admin CGI will maintain the Channel Map database (See section 5.7.3 for database file format). 
Carousel Explorer will setup a file change notification and perform the changes whenever the database file 
changes. 



2.Carousel Explorer will communicate with the MUX through dll function calls. 

Definition of the interface between the Arctos Carousel process and the shared memory input to the Mux. 
The Carousel process is concerned with creating and controlling shared memory input channels to | the Mux 
and with supplying image bitmaps for processing by| the Mux. 

The Mux is responsible for converting the bitmap into MPEG and sending the resulting frames according to 
how the j channel is currently configured. 
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Carousel-MUX data specifications: 

Prefix string A three letter zero-terminated string used to identify a group of related channels, 

eg. "Bis". 

Valid Range : any ASCII letters. 
Default Value : "AAA" 

Channel int number used to identify a specific channel in a group defined by the prefix. 

Valid Range : 1 to 4,095 

Default Value : User must specify 
Prog int Specifies the program ID number to be used for our PAT/PMT 

Valid Range : 1 to 65,535 

Default Value : User must specify 
Bit Rate float The bitrate in bits per second that should be used for the video elementary 

stream. This controls the image quality and refresh frequency of the MPEG frames that 

are transmitted. 

Valid Range : 10,000- 10,000,000 
Default Value : 50,000 

Hz float Video frames per second: must be one of these values -( 23.976, 24, 25, 29.97, 

30, 50, 59.94, 60 ). 
Valid Values : 23.976, 29.97 
Default Value : 29.97 

PID int The PID to use for the video ES in the mux output. Use -1 to dynamically assign 

a PID for the channel. 

Valid Values : 16-8190 

Default Value : User must specify 
PMT int The PID to use for the program's PMT in the mux output. Use -1 to dynamically 

assign this value. 

Valid Values : 16-8190 

Default Value : User must specify 
rowCount long Number of pixel rows in each input bitmap. 

Valid Values : 480 

Default Value : 480 
colCount long Number of pixel columns in each input bitmap. 

Valid Values : 640 

Default Value : 640 

PixelType int Some number that identifies the pixel type so that the bitmap format can be 

interpreted for MPEG encoding. 

Default Value: 2 = cmRGB565 
Buffer string OUT: On return from 'CmAddChannelO' and 'CmUpdateChannelO' this field 

holds the address of the buffer where bitmap data should be put for input to the channel. 
DataSize string OUT: On return from 'CmAddChannelO' and 'CmUpdateChannelO' this field 

holds the number of bytes allocated for bitmap data at 'Buffer'. 



Dll will have the following methods: 

int CmAddChannel( CmChannelSpec* ); 
int CmRemoveChannel( char*, int ); 
int CmResumeChannel( char*, int ); 
int CmResumeAl!(); 
int CmSuspendChanneI( char*, int ); 
int CmSuspendAllO; 

int CmUpdateChannel( CmChannelSpec* ); 
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5.3.3 Carouse! Scripts 

The carousel scripts are html pages that can be updated using one of the following techniques: 

1 . HTML Tinier - In this case the HTML page must contain a timer that tells the page to either update or 
navigate to a new URL. 

2. AutoRefresh Timer - The channel will be setup with one URL that is refreshed at a certain interval. 
This technique should be used if there is content consists of one html page that is changed frequently. 

3. AutoCapture Timer - The channel will be setup with one URL that is captured at a certain interval. 
This technique should be used it the html page contains an ActiveX component that changes without 
sending a navigate change event. 

Procedure for capturing new frames: 

1. New page is loaded into browser window or AutoRefresh or AutoCapture timers are fired 

2. The Channel Document adds itself to the update queue. 

3. A timer running in the main window checks this queue at a certain interval. Whenever a new document 
is found it's view is brought to the top of the display (Carousel Explorer can only capture windows that 
are visible in the display). 

4. A second timer gives the window enough time to redraw. 

5. The view image is captured and passed to the MUX. 

Error handling: 

In the event that a page was not loaded successfully, Carousel Explorer will follow this procedure: 

1 . Carousel Explorer will attempt to display the ErrorURL that was specified with the channel definition. 

2. If this page is not found or could not load, the default ErrorURL page (which is local) will be 
displayed. 

3. The channel will transition to an error state and send an alert to the alert manager. 

4. The channel will remain in this state until the problem is fixed. 

5.3.4 Channel Map Frame 

The channel map frame will display status information for each channel and provide an interface for 
modifying the channel map. 

The channel map list will provide the following information; 

1. Items will be sorted by status and channel number. Channels with errors will be at the top of the list 

2. Each item will be color coded to indicate the status. 

i) Blue - Channel is active 

ii) Grey - Channel has been deactivated 

iii) Red - Error 

3. The list will include these columns 

i) Channel status icon (Active, Inactive, Error) 

ii) Channel Number 

iii) Channel Name 

iv) Start URL 

The channel map toolbar will provide buttons for Adding, Removing, Updating, Activating and 
Deactivating a channel. To ensure that only one process maintains the database Carousel Explorer will send 
commands to modify the channel map to the Admin CGI. 

5.3.5 Alert / Log Frame 

The Alert / Log frame will display system status information or system alerts. The list will provide the 
following information: 

1 . Items will be color coded to indicate severity 
i) Red - severe error 
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ii) 
iii) 

2. Columns 



Orange - warning 
Yellow - informative event 



i) 
ii) 
iii) 
iv) 



Time 

Channel name or system component name 
Event text 



5.3.6 Status Frame 

The status frame will provide the following information: 

1 . Machine name (Arctosl or Arctos2) 

2. The background color of the frame will indicate whether this is the primary or backup machine. In the 
event of a sever error the frame background will blink 

3. System Uptime 

5.3.7 Main toolbar 

The main toolbar will provide access to the following functionality: 

1 . System configuration 

2. Shutting down the system and switching to the backup machine 

3 . MUX configuration 
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MPEG Encoder 

There are two possibilities for generating an IFrame for the screen shots. 

1. Use Ligos to compress the image data in software 

2. Use GI to compress the image data in hardware 

5.3.8 Functionality 

1. Receives a bitmap image from the Carousel Explorer and returns an encoded Iframe to the Carousel 
Explorer 

5.3.9 Interfaces 
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5.4 MUX 

The mux is responsible for continuously broadcasting an MPEG stream for every channel. 

5.4.1 Functionality 

1 . Continuously broadcast channels at 30 frames per second. 

2. 1 thread per channel 

3. Gets IFrame updates from the shared memory files produced by the Carousel Explorer 

4. Comes up in standby broadcasting null packed to Vivid mux. 

5. Creates shared memory and locks for mux control. 

6. Waits for channel create or other control messages. 

7. Creates shared memory and locks for new channels) 

8. Acknowledges that the new channel is created and ready to use. 

9. Channel messages include: 

a. Pause and Resume 

b. Channel content (pictures) 

c. Close channel (delete) and removes locks and shared memory for that channel. 

10. Mux Activate 

a. disables any other mux output to 1RT1000 

b. enables its own IRT 1 000 

c. start placing packets into output stream (which is running steadily) 

1 1 . Generate PAT's and PMT's for created channels. 

12. System configurable bandwidth throttle. 

13. Schedule Iframe between different channels. 

5.4.2 Interfaces 

1 . Shared Memory 

a. Channel controls 

b. Mux controls (add channels/start stop mux, query status and version number) 
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5.5 Alert Manager 

The alert manager will be responsible for monitoring the status of the system and interfacing with the 
monitoring software at the headend. The alert manager will consist of an interface dll and the SNMP 
Extendible Agent with an Arctos specific MIB. Alerts in this case also retrieve information, so they are 
more than just alerts in the normal sense. 

5.5.1 Functionality 

1 . Each piece of software must 'register' with the Alert Manager as it starts 

2. Registration implies 'up' status. 

3. Respond to SNMP requests from the monitoring software at the head end and the internal Arctos 
Software. 

a. Get 

b. GetNext 

4. Respond to SET requests from the Arctos Servers and Carousel Explorer, The head-end will request 
SET alerts through the administrator, not through SNMP requests directly. These will be requested 
through the DLL interface. 

5. Forward/Return the appropriate alerts. 

6. Types of alerts and disposition: 

a. Event - Places alert into Event Log 

b. Status - Replies with system status 

c. Version- Replies with the software version(s) 

d. Email - Sends email 

e. Reboot - Reboots server(s) 

5.5.2 Interfaces 

The AlertManager interface will be callable DLL entry points, which will handle the request or dispatch it 
to the SNMP Agent or other appropriate processes. 

1 . Register (const char* name, const char* version) 

2. Event(const char* event) 

3. int GetServerStatus(const int serverNumber) 

4. int GetSofhvareStatus(const char* name) 

5. const char*GetSoftwareVersion(const char* name) 

6. SendEMail(const char* message) 

7. RebootServer(const int serverNumber) 

8. SetServerStatus(const int serverNumber, const int status) 

9. SetSoftwareStatus (const char* name, const int status) 
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5.6 Administrator tools 

The administrator tools will be presented as HTML pages and will allow the addition, deletion, update and 
status of channels on the system. 

5.6.1 Functionality 

1 . Registers with Alert Manager 

2. Administration processes: 

i) Adding channels 

a) The Admimistrator uses the WEB Client connected to the ARCTOS Server on the 
primary machine telling it to add a channel. 

b) ARCTOS Server Updates Database 

c) The primary machine notifies the secondary machine of the change. 

d) Carousel Explorer picks up the new channel info. 

e) Carousel Explorer creates a new window and positions it in the new channel position. 

f) Carousel Explorer notifies the MUX of the new channel 

g) Load the first page and begin handling the page transitions. 

h) Return a either a success or failure HTML page to the content provider. 

ii) Removing 

a) The Administrator uses the WEB Client connected to the ARCTOS Server on the primary 
machine telling it to remove a channel. 

i) ARCTOS Server Updates Database 

b) The primary machine notifies the secondary machine of the change. 

c) Carousel Explorer picks up the change flag to remove the channel. 

d) Carousel Explorer removes the child browser window for that channel. 

e) The Carousel Explorer tells the MUX to remove the channel 

iii) Updating 

a) The Administrator uses the WEB Client connected to the ARCTOS Server on the primary 
machine telling it to change either the start URL. 

b) ARCTOS Server Updates Database 

c) The primary machine notifies the secondary machine of the change. 

d) Carousel Explorer picks up the updated channel info { including the new URL for the 
specified channel) 

e) Content Refresh 

iv) Status 

a) The Administrator uses the WEB Client connected to the ARCTOS Server on the primary 
machine requesting a status page. 

b) The ARCTOS Server generates a status page that contains 

1 . Channel number 

2. First URL 

3. Current URL 

4. Uptime 

5. Last time page was displayed 
c). Store reliability records. 
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5,6.2 User Interface 

The user interface for the Administration pages will be HTML forms accessible through a browser. The 
pages will be able to be 'branded' by the customer. 

ICTV Admin Pages\Channel Map is an application that provides a user interface to the channel map. 
User can add, remove, update, enable, disable channels. 



<5 Admin Pages - Miciosoft internet Explt i 
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5.6.3 Carousel Explorer Interface 



r- 1 
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Channel Map 



Update channel attributes ; 



Attribute 


Value 




Channel Number 






Channel Name 


|Channe!l1_ 




Start URL 






Channel Bitrate, (bps) 
Recommended : 299671 


500000.000000 




Encoding Bitrate (bps) 


(500000.000000 




(Auto Refresh Rate (ms) 


15000_ ^ 




Auto Caption Rate (ms) 


ll . _ ■ _ . ■ _ _ 




HTML Script 


l Felse 3 




PID 


20 




PMT 


20 . . . ] 


TCP Port 


1221 | 



Channel map data specifications: 



Channel # int 

Valid Range : 1 to 4,095 

Default Value : User must specify 
Channel Name string A mnemonic name for a channel. Maximum length - 1 00 characters 
Start URL string Maximum length - 1 00 characters. 
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Channel Bit Rate float The bit rate in bits per second that should be used for the video 

elementary stream. This controls the image quality and refresh frequency of the MPEG 
frames that are transmitted. 

Valid Ranee : 10,000 - to a limit, calculated from the System settings 
Recommended Value: calculated 



Encoding Bit Rate 
)■ 

PID 



float Video frames per second: must be one of these values - ( 23.976, 29.97 



PMT 



AutoRefresh 
AutoCapture 

HTML Script 
Mux Port 



int The PID to use for the video ES in the mux output. 
Valid Values : 16-8190 
Default Value : User must specify 

int The PID to use for the program's PMT in the mux output. 
Valid Values : 16-8190 
Default Value : User must specify 

int The channel will be setup with one URL that is refreshed at a certain interval. 

int The channel will be setup with one URL that is captured at a certain interval. 

(either AutoRefresh or AutoCapture must be 0) 

bool the HTML script or link 

int TCP port to be used in Mux for that channel 
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5.6.4 System Settings interface 



Assess r-«p V2CS 86 1 °9 I^BOTC/scr , '/runop * 



EX 



Channel Map 



System Settings: 



Attribute 



Value 



Transport Stream Id 
Serverl IRT1000 



Server2 IRT1000 

Total Bandwidth (MHz) F 
Total Available Bandwidth (MHz) F 

Transport Rate (bps) P 

Maximum Number of Channels P 

Encoding Bit Rate (bps) P 

i First Virtual Channel up 



.,j206.86.199l< 
j^OB 86 1 99_S_ 



MUX TCP Port Offset 



First PMT 
First PID 



J! 7 



J PID PMT Increment 



Transport Stream Id 
Serverl IRT1 000 
ServerURTlOOO 
Total Bandwidth 

Total Avail. Bandwidth 

Transport Rate 

Max # of Channels 

EncodingBitRate 



int 
int 
int 

int (MHz) 

Default Value : 6 

int (MHz) 

Default Value : 2 

int (Bps) 

Default Value : 26970360 

Default Value : 30 

double The bitrate in bits per second that controls the image quality setting in 

the MPEG encoder. 

Valid Rang e: 1,000,000- 10,000,000 



21 



Arctosl.O 



- FS002.01.01 

ICTV, Inc. Confidential 



Default Value : 5,000,000 
rowCount long Number of pixel rows in each input bitmap. 

Valid Values : 480 
Default Value : 480 

colCount long Number of pixel columns in each input bitmap. 

Valid Values : 640 
Default Value : 640 

defaultSystemURL string Number of pixel columns in each input bitmap. 
minRefreshRate long sec 
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5.7 Failsafe 

Windows NT clustering will be used to set up a primary/secondary server relationship. We will use the 
cluster address to 'get to' the server(s). NT clustering will then pass the traffic to the correct server. When 
a server fails, it is taken out of the cluster and all traffic is transferred to the other member(s) of the cluster 
with no interruption of the traffic flow. This will require NT Server 4.0 SP6 with the load balancing option 
(wlbs). You can still access the individual servers through their unique IP addresses. 

This system will be set up as a cluster in which there is a primary and a secondary server. When the 
primary server crashes or fails, the secondary server must be able to take its place, in a reasonable amount 
of time. If any portion of the software fails, the server must be able to recover without loss of service. Each 
system must have it's own copy of the software and data, which must be synchronized. When the problem is 
corrected, the server that became the primary server stays as the primary server and the recovered server 
becomes the secondary server. 

5.7.1 Startup and Operation 

1 . One machine is initially setup as a primary server while the other is setup as a secondary server 

2. Primary machine notifies the logging service that it is up and is the primary 

3. The primary machine loads the channel carousel and begins broadcasting 

4. The secondary server realizes it is the secondary and requests file synchronization 

5. Secondary server notifies the logging service it is up and is the secondary 

6. When changes to the channel carousel are made, the secondary is notified (see 5.7.1) 

7. Periodic file synchronization will be requested from the secondary. 

5.7.2 Failures scenarios: 
5.7.2.1 Primary server fails 

1 . The secondary server realizes that the primary server failed 

2. Alerts are sent to the alert manager 

3. The secondary should have all the channels loaded and setup 

4. The secondary server sets itself as a primary server 

5. T he ArctosServer module is an NT service, it will be already running and ready to take over 

6. Broadcasting resumes with only minor interruptions in service 

7. Human intervention may be required to fix the failed server. 



5.7.2.2 Secondary server fails 

1 . The primary server realizes the secondary server has failed 

2. Alerts are sent to the alert manager 

3 . The primary continues broadcasting 

4. Changes are applied and not synchronized 

5. Human intervention may be required to fix the failed server. 

5.7.2.3 Failed server Recovers: 

1. Failed server is recovered and comes back on line and registers as secondary server 

2. Alert is sent to the alert manager that the server is back up 

3. Server requests file synchronization 

4. Changes on primary are now only considered applied after secondary responds. 
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5.7.2.4 Failed Server Processes 

1. Process failures (services or programs or dlls) should be handled by the process itself. 

2. Process fails (GPF or other condition) 

3. Alert is sent to the alert manager, with as much info as possible 

4. Process is restarted. If the process fails again, the secondary server will take over. If the process fails 
on the secondary server, data will be refreshed. A failure after the data refresh will be fatal. We don't 
want to get into a catch-22 with ping-pong failures. 

5. Human intervention may be required to fix server. 



5.7.3 Synchronization 

1 . If the secondary is up and running, any change is not considered applied until the secondary machine 
replies that it has applied the change 

2. If the secondary i s not responding, the change is applied and marked complete. When the secondary 
machine comes back on-line, it will request file synchronization. 
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6. Test Plan 

The test plan for this project is contained in the Arctos Test Plan, document number TP000 i .0 1 , by the 
Arctos Team 

7. Test Report 

The Test Report section will be completed at the end of the project. It should include the results of the 
testing process, the number and nature of any outstanding issues or problems, and any recommendations for 
future improvements in development, testing, or release practices. 
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